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SUMMARY OF AMENDMENTS 



Operator Commands 



The folloMing operator commands have been modified to 
include support for the IBM Series/1 ^969 Magnetic Tape 
Subsystem : 

• $C 

• $VARYOFF 

• eVARYON 



Session Manager 






The following changes have been made to the Session Man- 
ager for the Event Driven Executive Version 2 
(5719-UT^) : 



$PL/I (Option 10) has been added to the Program 
Preparation secondary option menu to support the 
PL/I comp i ler . 

Option 3 "Disk Utilities" of the primary option menu 
has been changed to "Data Management". 

$TAPEUT1 (Option 10) has been added to the "Data 
Management" secondary option menu to support tape 
management . 



$TAPEUT1 Utility 



This new utility is described in Chapter 4. The tape 
READ/WRITE return codes are described in Chapter 6. 
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This utility has been updated to include support for 
locating tape data sets* 



$JOBUTIL - Job Stream Processor 



This utility has been updated to support the PL/I 
compiler. 



Suggested Utility Function Table 



This table has been expanded to include all the utility 
programs within this book for easy reference to their 
functions and commands. 



Glossary 



NeM terms have been added to the glossary. 



Reor^an i zat i on 



The book has been reorganized. It is now divided into 
six chapters with an introduction for each chapter. 

Chapter ^ presents the utilities in alphabetic order. 
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Subject tabs have been added to the upper outside cor 
ners of Chapters 1 through 6 of the book. 



Bjl?JiiQ,grap!lY 



The Bibliography lists the books in the Event Driven 
Executive Library and a recommended reading sequence. 
Other publications related to the Event Driven Executive 
are also 1 i sted . 



NjsqgUangQM? C>^ang?s 



This manual has been modified to include neM function 
and to improve technical accuracy and clarity. Addi- 
tional material and technical changes are indicated by 
vertical bars in the left margin. 
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HOW TO USE THIS BOOK 

The material in this sectionis a guide to using thisbook. It \^ 

defines the purpose* audience^ and content of the book as well 
as listing aids for using the book and background materials. 



PURPOSE 

The purpose of this publication is to describe how to use the 
f ol lowi ng t 

The operator commands to perform various system control 
f unct i ons 

The Session Manager to directly invoke utilities 

The Batch Job Stream Processor C$JOBUTIL) to invoke prede- 
fined sequences of utilities 

The data management! terminal* graphics* text editing* 
program preparation* and diagnostic utilities 

The messages and codes issued when using the Event Driven 

Executive ^ 

v.. 

AUDIENCE 

This manual is intended for use bys 

• System programmers to aid in generating a system to meet 
the requirements of the installation 

• Application programmers to prepare and execute application 
programs 

• Operators to run the system. 
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HOM THIS BOOK IS ORGANIZED 



This book contains six chapters: 

"Chapter 1. Overview" provides an overview of the contents 
of the book , 

"Chapter 2. Operator Commands" describes the operator com- 
mands and hoM to use them. 

"Chapter 3. Session Manager" describes the method used to 
interactively access programs from a set of predefined 
menus and associated procedures. 

"Chapter ^. Utilities" describes the utilities and how to 
use them. This chapter contains a table which cross refer- 
ences the utilities. It shows the utility and command to 
use to perform the desired function. 

"Chapter 5. Application Program Preparation" describes the 
program preparation utilities and how to use them. 

"Chapter 6. Messages and Codes" describes the messages and 
codes issued by the Event Driven Executive and explains 
thei r mean i ng . 



AIDS IN USING THIS PUBLICATION 



Illustrations in this book are enclosed in boxes. Many illus- 
trations display output formats printed while using the Event 
Driven Executive system. In those cases where the actual print- 
er output exceeds the size of the box* the information is 
illustrated in a compressed format. 

Several other aids are provided to assist you in using this 
book ! 

• A Summary of Amendments lists the significant changes made 
to this publication since the last edition 

• A Bi bl i ography : 

- Lists the books in the Event Driven Executive library 
along with a brief description of each book and a 
recommended reading sequence 

Lists related publications and materials 

• A Glossary defines terms 
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• A Common Index which includes entries from each book in the 

Event Driven Executive library /f \ 

Related Publications 

Related publications are listed in the Bi bl i ography . 

SUBMITTING AN APAR 

If you have a problem with the Series/1 Event Driven Executive 
services* you are encouraged to fill out an authorized program 
analysis report (APAR) form as described in the IBM Series/1 
Authorized Program Analysis Report (APAR) User's Guide * 
GCS'^-OO??. 
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Overview 



CHAPTER 1. OVERVIEM 



The following Event Driven Executive system components are 
described in this book: 



Operator commands to invoke programs and provide other 
system control functions 

A session manager to invoke the utilities from option menus 

Data management utilities to maintain disk* diskette^ and 
tape data 

Diagnostic utilities to aid in hardware and software 
debuggiiig 

Graphics utilities to define, display, and maintain graph- 
i c data 

Terminal utilities to define and modify terminal control 
i nf ormat i on 

Text editing utilities to enter and edit source data 

Program preparation utilities for system and application 
program development 

Messages and codes to aid you in operation of the system 



Each of these components is discussed later in the book in 
detail. A brief description of each follows. 



OPERATOR COMMANDS 

Twelve operator commands provide functions you can perform at 
your terminal. Commands that require parameters prompt you for 
them. Commands are accessed via the ATTN key of the ^978 or ^^979 
display terminals or the ESC or ALT MODE key on teletypewriter 
terminals. 

The operator commands and the functions they perform are: 

$A Display loaded program names and locations 

SB Blank a <^978/^979 screen 
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$C Cancel s program 

SCP Change a terminal's partition assignment 

$D Dump storage 

$E Eject printer page 

$L Load a program 

$P Patch storage 

$T Enter the date and time 

$VARYOFF Set a device offline 

$VARYON Set a device online 

$W Display the date and time 

SESSION MANAGER 



The session manager is a menu-driven interface used to access 
both system functions and your applications through a set of 
predefined full screen menus and their associated procedures. 
See "Chapter 3. The Session Manager" on page 27 for a detailed 
description on the session manager. 



V-> 



UTILITIES 

The utilities are a set of programs that provide productivity 
aids for Series/1 application program development and system 
ma i ntenance . 

To aid you in using these utilities? the Event Driven Executive 
system provides three ways to invoke the utility programs from 
a termi nal : 

• The session manager 

• The job stream processor utility ($JOBUTIL) 

• $L command 
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Most utility programs are used interactively from a terminal. 
After a utility program is invoked* you can list its defined 
operations and command by entering a question mark in response 
to the 'COMMAND (?):' prompt. 

In Chapter ^» the utility programs are presented in alphabetic 
order along with examples of their usage. 

The session manager groups the utility programs by function. 
The following represents the functional groupings of the util- 
ities along with the operations they perform. 



Text Editing Utilities 

The text editing utilities provide facilities for entering and 
editing source programs as follows: 

SEDITl A line editor that uses host data sets 

$EDIT1N A line editor that uses Series/1 data sets 

$FSEDIT A full screen editor that uses Series/1 or host data 
sets 



Program Preparation Utilities 

The program preparation utilities aid ins 

SCOBOL Compiling COBOL programs 

SEDXASM Compiling Event Driven Language programs 

$EDXLIST Reformatting $EDXASM listings 

$FORT Compiling FORTRAN programs 

$LINK Link editing more that one program together 

$PL/I Compiling PL/I programs 

$PREFIND Prefinding data sets and overlay programs to shorten 
program loading time 

$S1ASM Assembling Series/1 assembler language programs 
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$UPDATE Converting an object program into an executable load 
module 

SUPDATEH Converting a host object program into an executable 
load module 






Data Management Utilities 

The data management utilities aid in! 

$COMPRES Compressing disk or diskette libraries 

$COPY Copying disk or diskette data sets or volumes 

SCOPYUTl Copying data sets and volumes with dynamic 
allocation of the receiving data sets 

$DASDI Initializing, formatting, and verifying disks or 
d i skettes 

SDISKUTl Allocating and deleting data sets; listing directory 
data 

$DISKUT2 Patching and dumping data sets; listing the error 
log data set 

$DISKUT3 Performing data management functions from another 
program. $DISKUT3 is described in the System Gui de . 

$IAMUT1 Building and maintaining Indexed Access Method data 
sets 

$INITDSK Initializing and verifying a direct access storage 
volume for use with the Event Driven Executive 

$MOVEVOL Transferring volumes of data between systems and 
creating backup copies of an online data base 

$PDS Organizing and accessing partitioned data sets from 
another program. $PDS is described in the System 
Guide . 

STAPEUTl Allocating tape data sets, copying data sets or vol- 
umes from disk or diskette to tape, from tape to disk 
or diskette, or from tape to tape, and changing tape 
attr i butes . 
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Terminal Utilities 

The terminal utilities aid in: 

SFONT Creating and modifying character image tables for 
your display terminal 

SIMAGE Defining formatted screen images 

$PFMAP Displaying program function key assignments 

$TERMUT1 Altering logical device names» address assignments* 
or terminal configurations 

$TERMUT2 Defining routines and changing key definitions on 
the ^978 keyboard. Restoring the 497^ printer to the 
standard character set. 

$TERMUT3 Sending messages from one terminal to another 

The Multiple Terminal Manager utility programs are documented 
in the Communications and Terminal Applications Guide . 



Graphics Utilities 



Under the direction of a display processor* three graphics 
utilities aid in? 

$DICOnP Generating and modifying displays using an online 
composer 

SDIINTR Using an interpreter to display and process the data 
base 

$DIUTXL Maintaining the resulting data base 



Communications Utilitie s 



The communications utilities aid in: 

$BSCTRCE Tracing the I/O activities on a given binary synchro 
nous communications line 
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SBSCUTl Formatting binary synchronous trace files to either a 
printer or a terminal 

$BSCUT2 Exercising BSCAM capabilities 

$RJE2780 Simulating a 2780 RJE interface 

$RJE3780 Simulating a 3780 RJE interface 

$PRT2780 Printing spool records produced by $RJE2780 

$PRT3780 Printing spool records produced by $RJE3780 

$HCFUT1 Interacting with the Host Communications Facility 

The communcat i ons utilities are documented in the 
Communications and Terminal Applications Guide . 

Diagnostic Utilities 



.y 



The diagnostic utilities aid in: 

$DEBUG Debugging programs 

$DUMP Formatting and displaying the data saved by $TRAP on an 
error cond i t i on 

$IOTEST Performing the following functions: 

Testing the operation of sensor based I/O features 

Listing the hardware configuration of the Series/1 

Listing the devices supported by the system 

Listing volume information 

ogging I/O errors into a data set 



SLOG 
STRAP 



ntercepting certain class interrupts and recording 
the environment on a disk or diskette data set 
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MESSAGES AND CODES 



Nhile using the Event Driven Executive, you may encounter 
return codes, completion codes, and messages. They are found in 
Chapter 6. Messages and Codes. 



HARDCOPY FUNCTION FOR THE ^978/^979 DISPLAY 



Pressing the PF6 key or the assigned hardcopy key on the 
4978/4979 keyboard causes the entire display (24 lines) to be 
transferred to the designated hardcopy device. (During system 
generation, the TERMINAL statement is used to define the hard- 
copy device.) If the hardcopy device has not been defined or is 
currently busy with another operation, then no action is taken. 
Otherwise, the screen cursor moves to each line as it is 
printed, returning to its original position after the page is 
printed. The hardcopy function should not be activated while 
the screen is being changed. 
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CHAPTER 2. THE OPERATOR COMMANDS 



Twelve operator commands provide system control functions you 
can perform at your terminal. The operator commands begin with 
the character $ and are directed to the supervisor. (The com- 
mands directed to the various utilities are described in 
"Chapter ^t The Utilities" on page ^7 for each utility). 
Commands that require parameters will prompt you for them. 

The operator commands and the functions they perform are: 

$A Display loaded program names and locations 

$B Blank a ^978/^979 screen 

$C Cancel a program 

$CP Change a terminal's partition number 

$D Dump storage 

$E Eject printer page 

$1. Load a program 

$P Patch storage 

$T Enter the date and time 

$VARYOFF Set a device offline 

SVARYON Set a device online 

$W Display the date and time 

INVOKING THE OPERATOR COMMANDS 



To invoke the operation commands^ press the ATTN key on the 
4978 or 4979 (designated attention key on the teletypewriter 
terminal). Then enter the desired command in response to the 
prompting message > from the supervisor. 

Note : If the system includes more than 64K bytes of storage* 
the $A» $C» $D» $L> and $P functions operate only within the 
storage partition assigned to the terminal. 
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ENTERING COMMAND PARAMETERS 



.y 



You are prompted for required parameter information* for exam- 
ple* the storage addresses to be displayed by $D or the name of 
theprogramtobeloadedby$L. 

Note : In the syntax definitions in this chapter, the required 
fields need not be entered on the same line as the command. 

An alternate method for entering the operator commands is the 
single line format. This format alloMS you to enter successive 
fields, separated by blanks, as a single entry. This can be 
done for as many fields as the system can process before it must 
print an informational response. A possible entry using single 
1 i ne format i s s 



$L $EDXASM CALCSRC ASMMORK ASMJOB 



x.--^^ 
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OPERATOR COMMANDS 



$A - List Active Programs 



Displays the names and load points of all programs that are 
active within the partition to which the requesting terminal is 
assigned. Programs that were loaded by operator commands 
entered at your terminal are identified by an asterisk. 

Syntax 



Requ i red : 
Default: 



None 
None 



No operands are supported. 



Example - Display active programs 



> $A 

PROGRAMS AT 08:14 
IN PARTITION f5 

$5MMAIN 0000 * 

$JOBUTIL 0400 ^ 

$DISKUT1 0800 ^ 

$C0PYUT1 2600 



19 
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$B - Blank Display Screen 



Blanks or erases the requesting terminal's (4978/4979) screen* 
both protected and unprotected areas. 



Syntax 



$B 

Requ i red : 

Default : 



None 
None 



No operands are required 



Example - Blank screen 



> $B 

Note • Display screen is blanked 



v,y 
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$C - Cancel Program 



Operator Commands 



Cancels a program and frees the storage that it occupied. When 
more than one copy of the program is in your partitioni you are 
prompted to specify the load point of the program you wish to 
cancel. Use $A to obtain the load point. 

$C will also closet rewind* and set offline any tape data sets 
defined in the program header of the cancelled program. If a 
tape drive is online and targetted to receive data» the oper- 
ation will complete and tape will be set offline. 

Cauti on? Do not use the $0 command as a normal means of termi- 
nating program execution. Use it only as an aid when no other 
way exists to force termination of a program (such as a program 
to be cancelled is in an endless loop of instructions). $C can 
cause unpredictable errors (the task error exit is not taken) 
and should only be used as a last resort to avoid having to IPL 
the system again. 

Syntax 



$C 

Requ i red : 

Default: 



program 
program 
None 



Operands Descr i ot i on 

program The name of the program to cancel 

Example - Cancel $EDIT1 



> $C SEDITX 

$EDIT1 CANCELED AT 08:16:2-^ 
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$CP - Change Terminal's Partition Assignment 



This command alloujs you to change the partition number assigned 
to your terminal. If an invalid partition number is specified* 
an error message is displayed. 

Note ? If you are using a 4952 processor* you are limited to 
part i t i ons 1 and 2 . 

Syntax 



$CP 

Requi red : 
Default: 



n 
n 
None 



Operands Descr i pt i on 
n 



The partition to which the terminal is to be 
ass i gned . 



Example ~ Assign terminal to partition 2 



^ i*^ 



> $CP 

PARTITION # ? 2 
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$D - Dump Storage 



Dumps the contents of storage in hexadecimal on the terminal 
Syntax 



$D or i g 1 n » address » count 

Required? or i g i n > address » count 
Default: None 






Operands Descr i ot i on 

origin The hexadecimal origin address (the program load 
point). 

address The hexadecimal address in the program at Mhich the 
dump i s to start . 

I count The decimal number of words to dump. 



Example ^ Dump first 10 words of partition 



> $D 

ENTER origin: 0000 

ENTER ADDRESS, count: 0000,10 

OQOO: 6802 6AF6 0000 0000 6C34 6AF2 6C3^ 6AF2 

OOIO: 0000 0000 

ANOTHER DISPLAY? N 
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$E - Eject Printer 



( 



Causes the <^974 or '^973 printer (defined as $SYSPRTR) to 
advance to the top of the next page a specified number of times. 

Syntax 



$E 

Requ i red * 

Default: 



n 

None 

Ejects one page 



Operands Descr i pt i on 

n The number of pages to eject 

Example - Elect page on printer 




\,^_y' 
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$L - Load Program 



Loads a program from disk or diskette and starts it 
Syntax 



$L program* volume > storage data set(s) 

Required: program 

Default: volume defaults to IPL volume 






Operands Descr i ot i on 

program The name of the program to load. 

volume The name of the volume which contains the program to 
load . 

storage The total additional storage to be added to the end 
of the loaded program. 

data set(s) Data set(s) to be passed to the program being 
loaded (if required). Specify the data set(s) in 
the order the program expects. 



Example - Load a Program Called PROCESS from EDX003 and Pass a 
Single Data Set> HYDATA 



> $L 



PROCESS, EDX003 MYDATA 



Note : Wait until the system is initialized before loading a 
program. If your system has timers* the system is initialized 
when the »SET TIME AND DATE USING $T» appears (or when the time 
and date are printed). If your system does not have timers* the 
system is initialized when it enters the wait state after the 
storage map has been displayed. 
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$P '- Patch Storage 



AlloMs main storage to be patched online. Enter the patch data 
in response to prompting messages. 

Syntax 



$P or i g i n » address I count 

Required? or i g i n » address » count 
Default: None 



Operands Descr i pt i on 

origin The hexadecimal origin address (program load 
point). 

address The hexadecimal address in the program at which the 
patch i s to start . 

I count The decimal number of words to patch. 



\y 



Example - Patch word X'lOO* of program loaded at to X|FFFF' 



> $P 

ENTER ORIGIN: 0000 

ENTER ADDRESS, COUNT: 0100,1 

0100: C<+62 

DATA: FFFF 

ANOTHER PATCH? N 
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Enters a nsM date and time into the system and resets the 
realtime clock. You can only use $T from terminals having the 
label $SYSLOG and $SYSLOGA. After entering the time, the timer 
is started at the instant carriage return/ENTER is pressed. 
This resets the seconds to zero. 

I Notes: 

1. Make sure your time and date entry is correct as the system 
does not verify this data. 

2. If $T is entered from other than $SYSL06 or $SYSLOGA, it is 
equivalent to entering $W. 

Syntax 






$T 

Requ i red : 

Default: 



date » t i me 
da te » t i me 
date defaults 
t i me defaults 



to 
to 



00/00/00 
00:00:00 



Operands Descr i pt i on 
date The current date 
time The current time 

Example - Set date and time 



> $T 

DATE(M.D.T) : 8:22:79 

TIME(H.M): 11:15 
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SVARYOFF - Set Device Offline 



'X 



Sets the status of a disk, diskette, diskette magazine unit, or 
tape drive to offline. 

On the 4966 diskette magazine unit, each diskette volume in 
individual diskette slots or either of the diskette magazines 
can be set to offline. 

When you vary a tape device offline, that tape drive is rewound 
to the load point and set logically offline. 

Syntax 



$VARYGFF 
Requ i red t 
Default: 



i oda slot 
i oda 
None 



Operands Descr i ot i on 

ioda The hexadecimal device address of the device to be 
varied offline. 

slot The slot number (1,2, 3, A, B) of the diskette to be 
varied offline. This parameter applies to the <^966 
only . 



.•^'' ^x 



K.-J^ 



Examples * 

Vary offline the volume in slot 2 of a <+966 device at address 22 



> SVARYOFF 22 2 
IBMIRD OFFLINE 
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Vary offline tape drive at device address ^C on which a stand- 
ard label tape volume (volume serial 123456) was mounted and is 
d i splayed . 



> $VARYOFF ^C 
123456 OFFLINE 



Vary offline tape drive at device address 4E. In this example^ 
the tape drive was defined for non-labeled (NL) tapes or for 
bypass label-processing (BLP). Therefore* the tape ID assigned 
to that device at system generation is displayed. 



> $VARYOFF <»E 

TAPEl OFFLINE 



Note ' If you vary offline a tape drive that is online and 
use» you are prompted as follows! 



i n 




If response is N» the tape is not varied offline. If response is 
Y, the tape will be put logically offline (closed) and usable 
(ready to be varied online). This allows an "unclosed" tape 
drive to be recovered. 
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$VARYON - Set Device Online 



_y 



Sets the status of a disk» diskette* diskette magazine unit* or 
tape drive to online. 

On the ^966 diskette magazine unit» each diskette volume in the 
individual slots or either of the diskette magazines can be 
independently set to online. When a new diskette volume is 
mounted* the diskette volume must be online for it to become 
accessible. I/O commands issued to disk or diskette will not 
operate unless the device and/or the diskette volume is online. 

Before I/O commands can be issued to a tape* the tape must be 
mounted on a tape drive and varied online. 

$VARYON performs special tape functions* depending on the 
label type that is defined for the tape drive. 

• If the drive is defined for a standard label (SL) tape* the 
VOLl volume label is read. 

• If the drive is defined for a non-labeled (NL) tape* the 
leading tape mark (if one exists) is automatically 
bypassed or* if a label is encoupted* terminates without 
setting the tape online. 

• If the drive is defined for bypass label-processing (BLP)* 
no initial tape motion pccurs. 



V..y 



$VARYON also allows access to a multiple-file 
through a specified file sequence indicator. 



tape volume 



The tape drive must be set to the proper density at system 
generation or by the Change Tape (CT) command of the $TAPEUT1 
utility before you vary a tape' online. You can request that the 
expiration date on an SL tape data set be ignored. 
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$VARYON ioda slot|file 'EX' 

Requ 1 red : i oda 

Default: file defaults to 1» 



maximum value of 255 



I Note : The OR symbol (|) indicates mutually exclusive operands. 






Operands Descr i pt i on 

ioda The hexadecimal device address of the device to be 
var i ed online. 

slot|file The slot number (l»2y3»A»B) of the diskette to be 
varied online. This parameter applies to the ^966 
only. 

The decimal file number on the tape to be accessed. 
This parameter applies to the tape drive only. 



EX 



This parameter applies to tape only and requests an 
expiration date override. If a tape data set is ini- 
tialized with an expiration date» this parameter 
must be used to write to that tape data set and the 
file number must be specified. 



Examp les : 

Vary diskette in slot 1 of 4966 at device address 22 online 



> $VARYON 22 1 

IBMIRD ONLINE 



Vary a standard label (SL) tape (volume 123456) at address 4C 
online and access the first file. 
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> SVARYON <*C 

123456 ONLINE 



y 



Vary a non-labeled (NL) tape at address 4C online and access 
the second file, where TAPEl was the ID assigned at system gen- 
erat 1 on . 



> SVARYON 40 2 

TAPEl ONLINE 



Vary a standard label tape at address 4D online. The first file 
of this tape has an expiration date that has not expired; how- 
ever, output to this file is allowed. 



> SVARYON 4D 1 EX 

OVERRIDE EXPIRATION DATE CHECK? (Y,N); Y 

123456 ONLINE 
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$M - Display Date and Time 



Displays date and time* 
Syntax 



Requ i red : 
Default : 



None 
None 






No operands are supported. 
Example -• Display date and time 



> $W 

DATE = 08/22/79 TIME = 11:16:54 
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CHAPTER 3. THE SESSION MANAGER 



The session manager provides a quick and easy to use method of 
accessing programs (including the utilities) interactively 
from a terminal. Predefined full screen menus and associated 
procedures enable you to invoke the functions you request. Full 
screen ^9 78 or ^979 display terminals present prompting mes- 
sages and gather input parameters for processing system func- 
tions or application programs. Input requests are accompanied 
by prompting messages to help you supply all required informa- 
tion. 

The session manager requires a minimum partition of lOK bytes 
to process menus and your requests* but only 2K bytes remains 
resident during execution of the functions you request. Each 
terminal (4978 or 4979) has a dedicated copy of the session 
manager loaded into the partition to which that terminal is 
ass i gned . 



c 



INVOKING THE SESSION MANAGER 



You can invoke the session either of two ways: 



• as part of the IPL procedure 

• your request using $L (Load a Program) 

When you IPL the Event Driven Executive system* the session 
manager can be automatically loaded for each active 4978 or 
4979 display terminal and the logon menu (as shown in Figure 1) 
i 5 d i splayed . 



$SMMLOG: THIS TERMINAL IS LOGGED TO THE SESSION MANAGER 

17:55:31 
ENTER 1-4 CHAR USER ID =*> 05/24/79 

(ENTER LOGOFF TO EXIT) 

ALTERNATE SESSION MENU *«> 
(OPTIONAL) 



Figure 1. Session Manager logon menu 
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'">, 



If you wish to start the session manager at IPL t i me » you must 
rename the session manager module $SMINIT to $INITIAL, using 
the following $DISKUT1 utility command: 



RE $SMINIT SINITIAL 



The module $INITIAL> if presents is part of the IPL stream and 
is automatically loaded. 

If you do not wish the automatic start feature* you can load the 
session manager using the following command: 



$L $SriMAIN 



To begin a session* enter your user ID (one to four characters) 
and press the ENTER key. Use the ENTER key throughout the ses- 
sion for all data entry operations from the terminal. The user 
ID should be unique and not be used by more than one person 
simultaneously. This is because the user ID is used to create 
temporary work data sets whose names contain the four- 
character ID. Multiple use of the same ID results in sharing 
the same work data sets* with unpredictable results. 






N ot e : If you do not wish to use the session manager, enter the 
word LOGOFF instead of a user ID and the session manager term i - 
nates . 



SESSION MANAGER PROGRAM FUNCTION KEYS 



Four program function (PF) keys enable you to perform the fol- 
lowing functions: 

PFl Blanks the current screen image and allows system 
commands to be entered through prompting messages: 
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ENTERING SYSTEM COMMAND MODE - 
TO REENTER THE SESSION MANAGER, 
DEPRESS ATTN KEY AND ENTER '$SM': 



PF2 Restores the current screen image to its appearance when 
first displayed. Use this key to erase erroneous entries. 

PF3 Returns the previously displayed screen image. Use this 
key to back out from the current screen image. 

PF4 Returns you to the primary option menu. Use this key to 
return from any session manager screen. 



AUTOMATIC DATA SET ALLOCATION/DELETION 






The session manager allocates and deletes data sets at 
logon/logoff time. 



Data Set Allocation 

After you enter your user IDi the session manager allocates 
work data sets on a disk resident volume. The data set called 
$SMALLOC controls the data sets that are to be allocated. 
Figure 2 on page 30 lists the data set contents which consists 
of the data set prefix names* the sizes in 256-byte records, 
and the volumes to be used. 

The END statement indicates the end of the list of data sets to 
be allocated. Six data sets are usually allocated, five of 
which are temporary. Temporary data sets are deleted at the end 
of the session manager session. The data sets are allocated on 
volume EDX003. Figure 3 on page 31 lists the data sets, their 
sizes, and their functions. 

The data sets to be allocated, their volume, or size can be 
changed by using $FSEDIT or $EDIT1N to edit $SMALLOC. Four oth- 
er optional data sets ($SM4, $SM5, $SM6, and $SM7) can also be 
allocated. To change the number of data sets to be allocated, 
move the END statement behind the last data set to be allo- 
cated. To change a data set size or volume, change the size or 
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volume field. 

The only required data sets are $SMP and $SMW. They must be 
allocated on volume EDX003. 

For each user ID» a permanent parameter data set named $SMPuser 
is created. The last input parameters entered on a parameter 
selection menu are displayed^ allowing them to be used as is or 
changed. They are saved in the data set and recalled on the next 
invocation of the menu. 

When the data sets have been allocated^ the primary option menu 
is displayed on the screen and you can select the option 
des i red . 



$Sf1P 
$5MP 
$SMW 
$SME 
$SM1 
$SM2 
$SM3 
END 

$SM4 
$SM5 
$SM6 
$SM7 

^?^ $SMLO 
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NO 
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30 

30 
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EDXOO 
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EDXOO 
EDXOO 
EDXOO 
TERMINATOR 
DATASETS ?« 
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NOTE: 



DC 
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3 
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Figure 2. $SMALLOC contents 
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Data set Size in 256 



riam^ 



byte blocks Functional usage 



$SMEuser 



eSMPuser 



•^00 
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$SMMuser 



$SMluserJ* 



30 



^00 



$SM2user* 



<!»00 



$SM3user* 



250 



Used by the full screen text 
editor utility ($FSEDIT) as a 
Mork data set. 

Used by the session manager to 
save your input parameters 
from session to session. This 
data set is not deleted at the 
completion of a session. 

Used by the session manager to 
submit procedures via the job 
stream utility ($JOBUTIL). 

Used by the linkage editor ($LINK), 
the assembler ($S1ASM)» the com- 
pilers ($EDXASM, COBOL, PL/I, 
and FORTRAN IV as a work data set. 

Used by the linkage editor ($LINK), 
the Series/1 Macro Assembler 
($S1ASM), COBOL, FORTRAN IV, 
and Pl/I as a work data set. 

Used by the Series/1 Macro 
Assembler ($S1ASM), COBOL, 
and PL/I as a work data set. 



Notes? 

1. *user' in the data set name is replaced by your 
user ID. 

2. ^Using the session manager to invoke $S1ASM, COBOL, 
and PL/I requires that these data sets be deleted and 
reallocated. Recommended sizes for most programs are 
2000 records for $SMluser and $SM2user and 800 record 
for $SM3user. 



Figure 3* Data sets created by the Session Manager 
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Data Set Deletion 



Data sets created by the session manager can be deleted when 
you return to the logon menu. A prompt message is issued asking 
if you wish to save the data sets. To reply* enter a Y for yes or 
an N for no and press the ENTER key. Abnormal termination of the 
session manager prevents the deletion of the temporary data 
sets . 

The data set $SMDELET controls the data sets to be deleted at 
the end of the session. The data set contains the data set pre- 
fix names and the volumes on which they reside. The END state- 
ment indicates the last data set to be deleted. The data sets to 
be deleted should normally be the data sets that were allocated 
at the start of the session. Figure 4 lists the contents of the 
$SMDELET data set. 



$SME 
$SM1 
$SM2 
$SM3 
$SMW 
END 



$SMA 
$SM5 
$SM6 
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^x $ 
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PR 
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PR 
PR 
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PR 
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EFIX NAME AND VOLUME TO DELETE 
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INDICATES END OF DATA SETS TO 
9( 
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Figure ^. $SMDELET contents 
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SESSION MANAGER MENUS 



The session manager menus enable you to select options* such as 
text editing or program preparation* and to enter parameters. A 
unique procedure* associated with each menu* enables you to 
select option menus or to invoke through the batch job process- 
ing utility* $JOBUTIL* the functions you desire. 

Menus and procedures are stored in a library that resides on a 
direct access storage device. A menu is either a parameter 
selection menu or an option selection menu. You use a parameter 
selection menu to pass parameters to the program being invoked. 
The option selection menu is used to select other menus based 
on Mhich option is selected. 






When you log on to the session manager* the supplied environ- 
ment can be overridden by specifying a main option menu that 
you have created. This provides for additional environments 
tailored to your system. Option selection menus can be modified 
to add options that provide different environments for differ- 
ent users. (Procedures for modifying and adding new menus are 
discussed in the System Guide ). 

Figure 5 on page 34 shows the structure and the various paths 
that can be used to execute a requested function. When a func- 
tion completes* the most recently displayed menu is again dis- 
played. You can then change parameters and again request the 
function* or you can return to previously displayed menus by 
pressing the PF3 key. Use the PF3 key to return to a previous 
menu and* finally* to exit the session manager. 
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Level 1 



Logon 
menu 



Level 2 



User 

supplied 

nnenu 



Primary 

option 

menu 



Level 3 



Parameter 

selection 

menu 



Level 4 



Secondary 

option 

menu 



Execute 

requested 

function 



Execute 

requested 

function 



Tertiary 

option 

menu 



Level 5 



Parameter 

selection 

menu 



Execute 

requested 

function 



^'<^ 



Figure 5. Menu selection hierarchy 
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Primary Option Menu 



The primary option menu provides nine options as shown in 
Figure 6. The session manager automatically positions the 
cursor to accept input. Type in the desired option number and 
press the ENTER key. The function of each primary option is 
discussed in the following pages. 



$SMMPRIM: SESSION MANAGER PRIMARY OPTION MENU 

ENTER/SELECT PARAMETERS: DEPRESS PF3 TO RETURN 

19:<^2:07 
SELECT OPTION ==> 07/13/79 

USER 

1 - TEXT EDITING 

2 - PROGRAM PREPARATION 

3 - DATA MANAGEMENT UTILITIES 

4 - TERMINAL UTILITIES 

5 - GRAPHICS UTILITIES 

6 - EXEC PROGRAM/UTILITY 

7 - EXEC $JOBUTIL PROC 

8 - COMMUNICATION UTILITIES 

9 - DIAGNOSTIC UTILITIES 



Figure 6. Primary option menu 
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Secondary Option Menus 



Option 1 - Text Editing 



This option requires no further parameter input. When you 
select this option, the session manager loads the full screen 
text editor utility program $FSEDIT and passes control to it. 
The edit work data set used is the one automatically preallo- 
cated by the Session Manager. All further communication is 
directly between you and $FSEDIT. Commands for $FSEDIT can be 
found under "Primary Commands" on page 218. 

When $FSEDIT terminates, control returns to the session manag- 
er, the primary option menu is displayed, and another option 
can be selected . 



Option 2 - Program Preparation 



This option allows you to prepare programs for execution. By 
further specification on a secondary option menu, programs can 
be assembled, compiled, linked, updated, or listed. A second- 
ary option menu, as shown in Figure 7 on page 37, is displayed 
on the screen after you select the program preparation utili- 
ties option from the primary option menu. You can select one of 
the listed utility programs from it, 

A parameter selection menu is displayed based on which second- 
ary option you select. The menu allows entry of required param- 
eters such as: source input data set name, object output data 
set name, and assembler or compiler options. The selected 
parameters are saved from one session logon to the next. An 
example of the $EDXASM parameter menu is shown in Figure 8 on 
page 38. Parameter menus for other program preparation utili- 
ties are similar and self explanatory. The required work data 
set for assemblers, compilers, and the linkage editor are pre- 
allocated by the session manager. You must allocate the object 
data set . 






The following programs can be invoked from this option: 
$EDXASM Compiles Event Driven Language programs 
$S1ASM Assembles macro assembler language programs 
$COBOL Compiles COBOL programs 
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$FORT Compiles FORTRAN IV programs 

$LINK Link-edits program object modules 

$UPDATE Converts an object program to an executable program 

$UPDATEH Transmits and converts host assembled modules 

$PREFIND Locates data sets/overlays prior to loading a 
program 



I $PL/I 



Compiles PL/I programs 



Option 9 of the program preparation utilities option menu 
invokes the utilities referenced in the sequence shown. You can 
pass parameters to those programs as needed. 






$SMM02 SESSION MANAGER PROGRAM PREPARATION OPTION MENU- 
ENTER/SELECT parameters: DEPRESS PF3 TO RETURN 

SELECT OPTION ==> 

1 - $EDXASM COMPILER 

2 - $S1ASM ASSEMBLER 

3 - $COBOL COMPILER 

^ - $FORT FORTRAN COMPILER 

5 - $LINK LINKAGE EDITOR 

6 - $UPDATE 

7 - $UPDATEH (HOST) 

8 - $PREFIND 

9 - $EDXASM/$LINK/$UPDATE 

10 - $PL/I COMPILER/$LINK/$UPDATE 



o 



Figure 7. Program preparation utilities option menu 
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$SMM0201: SESSION MANAGER $EDXASM PARAMETER INPUT MENU 
ENTER/SELECT PARAMETERS: DEPRESS PF3 TO RETURN 



SOURCE INPUT (NAME, VOLUME) ==> 

OBJECT OUTPUT (NAME , VOLUME ) ==*> 

ENTER OPTIONAL PARAMETERS 

BY POSITION = = > 1 2 

LIST PRINTER NAME 

NOLIST 

ERRORS 

DEFAULTS ARE: LIST $SYSPRTR 



Figure 8. $EDXASM parameter selection menu 



Option 3 •- Data Management 



This option allows you to invoke the folloNing utilities: 

SDISKUTl Allocates and deletes data sets; lists directory 
data 

$DISKUT2 Patches and dumps data sets 

$C0PYUT1 Copies data sets with output data set allocation 

$COMPRES Compresses libraries 

$COPY Copies disk/diskette data sets and volumes 

$DASDI Initializes^ formats, and verifies disks or 
d i skettes 

SINITDSK Initializes and read-verifies a direct access 
storage volume 

$riOVEVOL Saves direct access volumes whose size requires 
multiple diskettes 



f^) 
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$IAMUT1 Builds and maintains Indexed Access Method data sets 

STAPEUTl Allocates tape data sets> copies data sets or 
volumes from disk /diskette to tape» from tape to 
disk/diskette, or tape to tape* and changes tape 
attr i butes . 

A secondary option menu, as shown in Figure 9, is displayed on 
the screen after you select the data management option from the 
primary option menu. You can select one of the listed utilities 
from i t . 



$SMM03 SESSION MANAGER DATA MANAGEMENT OPTION MENU 

ENTER/SELECT PARAMETERS: DEPRESS PF3 TO RETURN 



= > 



SELECT OPTION 


1 


— 


$DISKUT1 


2 


- 


$DISKUT2 


3 


- 


$C0PYUT1 


<^ 


-■ 


$COMPRES 


5 


- 


$COPY 


6 


- 


$DASDI 


7 


- 


$INITDSK 


8 


- 


$MOVEVOL 


9 


- 


$IAMUT1 


10 


- 


$TAPEUT1 



(ALLOCATE, LIST DIRECTORY) 

(DUMP/LIST DATA SETS) 

(COPY DATASETS/VOLUMES) 

(COMPRESS A VOLUME) 

(COPY DISK/DISKETTE DATASETS/VOLUMES) 

(DISK(ETTE) SURFACE INITIALIZATION) 

(INITIALIZE/ VERIFY DISK/DISKETTES) 

(COPY DISK VOLUME TO MULTI-DISKETTES) 

(MAINTAIN INDEXED DATA SETS) 

(TAPE ALLOCATE, CHANGE, COPY) 



WHEN ENTERING THESE UTILITIES, THE USER IS EXPECTED 
TO ENTER A COMMAND. IF A QUESTION MARK (?) IS ENTERED 
INSTEAD OF A COMMAND, THE USER WILL BE PRESENTED WITH 
A LIST OF AVAILABLE COMMANDS. 



I Figure 9. Data management option menu 



The $TAPEUT1 utility has been added to the secondary option 
menu of the Data Management utilities for the Event Driven 
Executive Version 2 (5719-UT'^). 
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o 



This option allows you to invoke the following utility pro- 
grams : 

$TERMUT1 Alters logical device names* address assignments* or 
terminal configuration parameters 

$TERMUT2 Defines routines and changes key definitions on the 
<^978 keyboard. Restores the 4974 printer to the 
standard character set. 

$TERMUT3 Sends a single line message from one terminal to 
another 



$IMAGE 

SFONT 

$PFMAP 



Defines formatted screen images for the 4978 or 4979 
display terminals 

Modifies character image tables for the 4978 
term i nal 



Identifies program function keys on 
term i na 1 



the 4978 



A secondary option menu* as shown in Figure 10 on page 41, is 
displayed on the screen after you select the terminal utilities 
option from the primary option menu. You can select one of the 
listed utility programs from it. 



J 



Option 5 -- Graphics Utilities 

This option allows you to invoke utilities to generate, store, 
and display information graphically or in reports. The follow- 
ing utility programs can be invoked from this option? 

SDIUTZL Performs utility functions on a display data base 

SDICOMP Composes existing display profiles and adds new ones 

$DIINTR Generates the requested display 

A secondary option menu, as shown in Figure 11 on page 41, is 
displayed on the screen after you select the graphic utilities 
option from the primary option menu. You can select one of the 
listed utility programs from it. 
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$SMMO'^ SESSION MANAGER TERMINAL UTILITIES OPTION MENU 

ENTER/SELECT PARAMETERS: DEPRESS PF3 TO RETURN 

SELECT OPTION ==> 

1 - $TERMUT1 (TERMINAL CONFIGURATOR) 

2 - $TERMUT2 (4978 KEYBOARD DEFINE) 

3 - $TERMUT3 (TERMINAL MESSAGE SENDER) 

4 - $IMAGE (SCREEN FORMAT BUILDER) 

5 - §FONT (CREATE/MODIFY CHARACTER IMAGES) 

6 - $PFMAP (DISPLAY PF KEY CODES) 

WHEN ENTERING THESE UTILITIES, THE USER IS EXPECTED 
TO ENTER A COMMAND. IF A QUESTION MARK (?) IS ENTERED 
INSTEAD OF A COMMAND, THE USER WILL BE PRESENTED WITH 
A LIST OF AVAILABLE COMMANDS. 



Figure 10. Terminal utilities option menu 






$SMM05 SESSION MANAGER GRAPHICS UTILITIES OPTION MENU— 
ENTER/SELECT PARAMETERS: DEPRESS PF3 TO RETURN 



SELECT OPTION ==> 



1 - $DIUTIL 

2 - $DICOMP 

3 - $DIINTR 



(GRAPHICS 
(GRAPHICS 
(GRAPHICS 



ORGANIZOR) 

COMPOSER) 

INTERPRETER) 



WHEN ENTERING THESE UTILITIES, THE USER IS EXPECTED 
TO ENTER A COMMAND. IF A QUESTION MARK (?) IS ENTERED 
INSTEAD OF A COMMAND, THE USER WILL BE PRESENTED WITH 
A LIST OF AVAILABLE COMMANDS. 



Figure 11. Graphics utilities option menu 



Option 6 - Execute Program 



This option allows you to execute any program. The program can 
be a system program or utility, or one of your application pro- 
grams. The parameter selection menu has provision for specify- 
ing the parameters and data sets that the program may need. 
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Option 7 - Execute $JOBUTIL Procedure 






This option allows the submission of previously built proce- 
dures to the job stream processor utility $JOBUTIL. A parameter 
selection menu allows entry of the procedure name and volume 
name it resides on. The procedure cannot invoke the name of 
another procedure. 



Option 8 - Communications Utilities 

This option allows you to invoke the following utility 
programs : 

SBSCTRCE Traces the I/O activities on a given binary 
synchronous communications line 

SBSCUTl Formats binary synchronous trace files to either a 
printer or a terminal 

$BSCUT2 Exercises BSCAM capabilities 

$RJE2780 Simulates a 2780 RJE interface 

$RJE3780 Simulates a 3780 RJE interface 

$PRT2780 Prints spool records produced by $RJE2780 

$PRT3780 Prints spool records produced by $RJE3780 

$HCFUT1 Interacts with the Host Communications Facility 

A secondary option menu, as shown in Figure 12 on page ^3 is 
displayed on the screen after you select the communications 
utility option from the primary option menu. You can select one 
of the listed utility programs from it. 



f V 
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$SMM08 SESSION MANAGER COMMUNICATION UTILITIES OPTION 

MENU 
ENTER/SELECT PARAMETERS: DEPRESS PF3 TO RETURN 

SELECT OPTION ==> 

1 - $BSCTRACE (TRACE BSCAM LINES) 

2 - $BSCUT1 (PRINT TRACE FILE) 
(ESC EXERCISER) 
(2780 RJE TO HOST) 
(3780 RJE TO HOST) 
(2780 SPOOLED RJE FILE PRINTER) 
(3780 SPOOLED RJE FILE PRINTER) 
(HOST COMMUNICATIONS FACILITY) 



3 - $BSCUT2 

^ - $RJE2780 

5 - $RJE3780 

6 ~ $PRT2780 

7 - $PRT3780 

8 - $HCFUT1 



WHEN ENTERING THESE UTILITIES, THE USER IS EXPECTED 
TO ENTER A COMMAND. IF A QUESTION MARK (?) IS ENTERED 
INSTEAD OF A COMMAND, THE USER NILL BE PRESENTED WITH 
A LIST OF AVAILABLE COMMANDS. 



Figure 12. Communications utilities option menu 



*\ 



Option 9 •- Diagnostic Utilities 

This option allows you to invoke the following utility 
programs 5 

$TRAP Saves the environment in a data set in case of error 

$DUMP Formats and displays the data saved by $TRAP 

SLOG Logs I/O errors into a data set 

$DISKUT2 Formats and displays the log data set on a printer or 
termi nal 

SIOTEST Tests sensor-based operations; lists system 
configuration and volumes 

A secondary option menu, as shown in Figure 13 on page ^A is 
displayed on the screen after you select the diagnostic utility 
option from the primary option menu. You can select one of the 
listed utility programs from it. 
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$SMM09 SESSION MANAGER DIAGNOSTIC AIDS OPTION MENU — 
ENTER/SELECT PARAMETERS: DEPRESS PF3 TO RETURN 



SELECT OPTION ==> 



$TRAP 

$DUMP 
$LOG 

$DISKUT2 
eiOTEST 



(CAPTURE PROGRAM INFORMATION TO 

DATA SET) 
(FORMATTED STORAGE/REGISTER 
(I/O ERROR LOGGING) 
(DUMP/PATCH DISK(ETTE) UTILITY 
(SENSOR I/O DEVICE EXERCISOR) 



WHEN ENTERING THESE UTILITIES, THE USER IS EXPECTED 
TO ENTER A COMMAND. IF A QUESTION MARK (?) IS ENTERED 
INSTEAD OF A COMMAND, THE USER WILL BE PRESENTED WITH 
A LIST OF AVAILABLE COMMANDS. 



Figure 13. Diagnostic aids utilities option menu 



A parameter se lect i on menu , as shown in Figure 14 is displayed 
on the screen after you select the $TRAP utility. Use the menu 
to enter the name of the data set to be used by $TRAP and the 
name of the volume containing the data set. 






$SMM090l: SESSION MANAGER $TRAP PARAMETER INPUT MENU - 
ENTER/SELECT PARAMETERS: DEPRESS PF3 TO RETURN 



$TRAP 

DUMP DATASET ( NAME , VOLUME ) ==> 



Figure 14. $TRAP parameter selection menu 



A parameter selection menu, as shown in Figure 15 on page 45 is 
displayed on the screen after you select the $DUMP utility. Use 
the menu to enter the name of the data set to be used for the 
dump and the name of the volume containing the data set. 
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$SMM0902: SESSION MANAGER $DUMP PARAMETER INPUT MENU 

ENTER/SELECT PARAMETERS: DEPRESS PF3 TO RETURN 



$DUMP 

DUMP DATASET ( NAME , VOLUME ) ==> 



Figure 15. §DUMP parameter selection menu 



A parameter selection menu* as shown in Figure 16 is displayed 
on the screen after you select the $LOG utility. Use the menu to 
enter the name of the data set to be used by $LOG and the name of 
the volume containing the data set. 






$SMM0903: SESSION MANAGER eiOG PARAMETER INPUT MENU — 
ENTER/SELECT PARAMETERS: DEPRESS PF3 TO RETURN 



$LOG 

LOG DATASET ( NAME , VOLUME ) ==> 



Figure 16. $LOG parameter selection menu 
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Menu Option Combinations 



When selecting a primary option* the secondary option* if 
applicable, can also be entered. This results in the secondary 
option being invoked without display of the secondary option 
menu. The secondary option is separated from the primary option 
by a period. 

Example : To request an assembly from the primary option menu* 
enter 2.1 as the selected option. You have selected primary 
option 2 (program preparation) and its secondary option 1 
($EDXASM - compile Event Driven Language program). The next 
menu displayed is the parameter selection menu C$SMM0201) for 
the compiler $EDXASM. 



Utilities Not Supported by Session Manager Menus 



The following utility programs are not supported by the Session 
Manager menus : 



$DEBUG 

$DISKUT3 

$EDIT1 

$EDIT1N 

$EDXLIST 

$PDS 

The Multiple Terminal Manager 

The Remote Management Utility 



utilities 
($RMU) 



With the exception of $DISKUT3 and $PDS, these utility programs 
can be invoked by entering the operator command $L (Load a Pro- 
gram) and the utility name. $DISKUT3 and $PD5 can only be used 
from a program using the LOAD instruction and are documented in 
the System Guide . $RMU is documented in the Communications and 
Terminal Applications Guide . 
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CHAPTER A. THE UTILITIES 



The utilities are a set of programs supplied with the Event 
Driven Executive system that allow you to interactively commu- 
nicate with the system and perform many functions necessary for 
Series/l application program development and system mainte- 
nance . 



INVOKING THE UTILITIES 



To aid you in performing utility functions* the Event Driven 
Executive system provides three ways to invoke the utility pro- 
grams from a terminal: 

• The session manager - You choose the desired utility pro- 
gram from a predefined optipn menu provided. Most utili- 
ties can be invoked in this manner. This is the easiest to 
use for interactive utilities because you need only enter 
option numbers (not program names) to access the function 
needed. 



^y 



$JOBUTIL - The job stream processor utility can be used to 
invoke a predefined sequence of program preparation utili- 
ties and pass parameters to them. $JOBUTIL can itself be 
invoked by the session manager. 



• $L command - Enter the operator command $L (Load program)* 
followed by the name of the utility of your choice. All 
utilities described in this book can be invoked in this 
manner . 

Most utility programs are used interactively from a terminal. 
After a utility program is invoked* you can list its defined 
ations and command codes by entering a question mark in 



oper 



response to the 'COMMAND ( ? ) : ' prompt. 
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SUGGESTED UTILITY USAGE TABLE 



The following table is intended to help you find the appropri- 
ate utility program and command to perform the function that 
you want to accomplish. To use it» find the activity and func- 
tion that you want to do in the left columns; the corresponding 
utility and command to accomplish the function are in the right 
columns. The program name indicated can be used on the $L com- 
mand to load that utility program. When using the session man- 
ager* the menu option corresponding to the program name on the 
secondary option menu can be selected to access the program. 
The command indicated is used to direct the utility to perform 
the desired function. 



m 
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ACTIVITY 



Act 1 vate 



FUNCTION 



UTILITY 



Error logg \ ng 
Stopped task 
TRAP f unct ion of 
storage dump 



$LOG 
$DEBUG 

$TRAP 



Allocate Data set 



new data set in a data 
base for a graphics 
display prof i le 



$DISKUT1 
$DIUTIL 
$IAMUT1 
$TAPEUT1 



$DICOMP 



Cancel Dump 

List option 

Multiple member copy 

Multiple member list 

Multiple record dump 

Multiple record list 



$DUMP 

$FSEDIT 

$C0PYLJT1 

$DISKUT1 

$DISKUT2 

$DISKUT2 



Change $EDXASM assembly of EDL 
Address assignment of 

a terminal 
Base address 
Execution sequence 
Graphic or report 

d i splay prof i le 
Hardcopy device 

assoc i ated Mi th 

4978/A979 
Host library 
Key definition in a 

4978 control store 
Name of logical device 
Page formatting 

parameters of a 

term i nal 



$EDXASM 

$TERMUT1 

$DEBUG 

$DEBUG 

$DICOMP 



$TERMUT1 
$UPDATEH 

$TERMUT2 
$TERMUT1 



$TERMUT1 



COMMAND 



$LOGON 
GO 

TRAPON 



AL 
AL 
OR 
TA 



AD 



Assign Alternate for defective 

'^963 sector $DASDI 3,1 

DEFINE key in a 4978 

control store $TERMUT2 AD 



CA 
CA 
CA 
CA 
CA 
CA 



CA 

RA 

QUALIFY 

GOTO 

AL,IN 



RH 
CH 

C 
RE 



CT 



Chapter 4. The Utilities 



49 



utilities 



ACTIVITY 



FUNCTION 



UTILITY 



COMMAND 



Change Series/1 library 

Tape drive attributes 
Trap f unct ion of 

storage dump 
Volume 



Clear 



Copy 



$UPDATEH 
$TAPEUT1 

$TRAP 
$DISKUT1 
$DISKUT2 
$UPDATE 



Data set to zero 



$DISKUT2 



Compress Graphics data base 
L i brary 



$DIUTIL 
$COMPRES 



All 

ex 
Part 

ex 
All 

di 

ta 
A ta 

or 
A ta 

an 
Abso 
Enti 

vo 
Memb 
Memb 

so 

ta 
All 

al 
Data 

al 
Prog 

al 
Gene 

al 
Non- 

al 



of da 
i s t i n 

of d 
i st i n 
of d i 
skett 
pe da 
pe da 

di sk 
pe da 
other 
1 ute 
re d i 
lume 
er wi 
er f r 
urce 
rget 
membe 
locat 

memb 
locat 
ram m 
locat 
r i c m 
locat 
gener 
locat 



ta set to 
g data set 
ata set to 
g data set 
sk or 

e data set to 
ta set 

ta set to disk 
ette data set 
ta set to 
tape data set 

sk or diskette 



th 
om 
dat 
dat 
rs 
i on 
ers 
i on 
emb 
i on 
emb 
i on 
i c 
i on 



al locat i on 
graphic 
a base to 
a base 
with 

wi th 

ers wi th 

ers wi th 

members with 



$COPY 
$COPY 

$TAPEUT1 

$TAPEUT1 

$TAPEUT1 
$COPY 

$COPY 
$C0PYUT1 

$DIUTIL 

$C0PYUT1 

$C0PYUT1 

$C0PYUT1 

$C0PYUT1 

$C0PYUT1 



CV 
CT 

$TRAPEND 

CV 

CV 

CV 



CD 



CP 
None 



CD 
CD 

CD 

CD 

CD 
CD 

CV 
CM 

CM 

CALL 

CAD 

CAP 

CG 

CNG 



/^"\ 
\^jj 
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ACTIVITY 



Display 



FUNCTION 



UTILITY 



Delete Member 

Prefound status of data 
sets and overlays 



$DISKUT1 
$DIUTIL 

$PREFIND 



Direct Output to $SYSPRNT 
Output to terminal 



$DISKUT1 
$DISKUT2 
$DISKUT1 
$DISKUT2 



<^978 p 

keys 
Charac 
Conten 

reg i 
Graph i 

d i sp 
Header 

i n g 
Indexe 

SE c 
Member 

data 
Status 
Status 

grap 
Vo lume 



rogram function 



ter i ma 
ts of s 
sters 
cs or r 
lay pro 

of a d 
raph i cs 
d A c c e s 
ommand 
s i n gr 

base 

of all 

of cur 
hies da 

i nf orm 



ge table 
torage or 

eport 
file 

ata member 
data base 
s Method 
parameters 
a p h i c s 

tasks 
rent 
ta base 
at i on 



$PFMAP 
$FONT 

$DEBUG 

$DIINTR 

$DIUTIL 

$IAMUT1 

$DIUTIL 
$DEBUG 

$DIUTIL 
$IOTEST 



COMMAND 



Define Indexed Access Method 

data set $IAMUT1 DF 
Formatted screen! 

- image dimensions $IMAGE DIMS 

- horizontal tab $IMAGE HTAB 

- vertical tab $IMAGE VTAB 

- null representation $IMAGE NULL 



DE 
DE 

DE 



LISTP 
PL 

LISTT 
LL 



Each key 
DISP 

LIST 

None 

LH 

DI 

LA 
WHERE 

ST 
VI 
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ACTIVITY 



Dump 



Help 



FUNCTION 



Data set or program on 
pr i nter 

Data set or program on 
console 

Tape on printer or 
term i na 1 



PROGRAM 


COMMAND 


$DISKUT2 


DP 


$DICOMP 


PR 


$DUMP 


None 


$DISKUT2 


DU 


$DICOMP 


PR 


$DUMP 


None 


$TAPEUT1 


DP 



Exercise Tape to verify it is 
executing correctly 
and surface is free 
of defects 



$TAPEUT1 



Generate Graphic or report 
display prof i le 



th 
th 
th 
th 
th 
th 
th 
th 
th 
th 
th 
th 
th 
th 
th 
th 
th 
th 



use 
use 
use 
use 
use 
use 
use 
use 
use 
use 
use 
use 
use 
use 
use 
use 
use 
use 



of 
of 
of 
of 
of 
of 
of 
of 
of 
of 
of 
of 
of 
of 
of 
of 
of 
of 



$COPY 

$C0PYUT1 

$DICOMP 

$DISKUT1 

$DISKUT2 

$DIUTIL 

$FONT 

OFSEDIT 

$IAMUT1 

$IMAGE 

$INITDSK 

$IOTEST 

$PREFIND 

$TAPEUT1 

$TERMUT1 

$TERMUT2 

$UPDATE 

$UPDATEH 



$DIINTR 



$COPY 

$C0PYUT1 

$DICOMP 

$DISKUT1 

$DISKUT2 

$DIUTIL 

$FONT 

$FSEDIT 

eiAMUTl 

$IMAGE 

$INITDSK 

$IOrEST 

$PREFIND 

$TAPEUT1 

$TERMUT1 

$TERMUT2 

$UPDATE 

eUPDATEH 



EX 



None 






\^ 
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ACTIVITY 



FUNCTION 



UTILITY 



In i t i al i ze 



List 



Load 



Log 



Disk 

Di skette 

For use with Event 
Dr i ven Execut i ve 
Graphics data base 
Log data set 
Tape 



$DASDI 
$DASDI 

$INITDSK 
$DIUTIL 
$LOG 
$TAPEUT1 



All membe 
All membe 
Breakpo i n 
Data memb 
Data memb 
Data set 
Data set 
Devices s 

system 
Hardware 
Log on pr 
Log on co 
One membe 
Program f 
Program m 

(CTS mo 
Program m 
Space ava 
Termi nal 

address 
Through v 



rs i n volume 
rs (CTS mode) 
ts/trace ranges 
ers (CTS mode) 
ers in volume 
on pr i nter 
on console 
upported by 



con 

int 

nso 

r 

unc 

emb 

de) 

emb 

i la 

nam 

es 

o lu 



f i gurat i on 

er 

le 

t i on keys 

ers in volume 

ble 

es/types/ 

mes 



$DISKUT1 

$DISKUT1 

$DEBUG 

$DISKUT1 

$DISKUT1 

$DISKUT2 

$DISKUT2 

$IOTEST 

$IOTEST 

$DISKUT2 

$DISKUT2 

$DISKUT1 

$IMAGE 

ODISKUTl 
$DI5KUT1 
$DISKUT1 

$TERMUT1 
$DISKUT1 



I/O errors into disk or 
diskette data set 



$LOG 



COWHAND 



2 

1 

I 

IN 

$LOGINIT 

IT 



LA 

LACTS 

BP 

LDCTS 

LD 

LP 

LU 

LS 
LD 
PL 
LL 
LM 
KEYS 

LPCTS 

LP 

LS 

LA 
LV 



A ^978 control store 

from a direct access 

data set $TERMUT2 LC 

Character image table 

into a <+978 $FONT PUT 

Indexed Access Method 

data set $IAMUT1 LO 



$LOGON 
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ACTIVITY 



FUNCTION 



UTILITY 



Move 



Patch 



Data set or program 
Storage or registers 



$DISKUT2 
$DEBUG 



Preallocate Data s^ts and overlays 



$PREFIND 



Post 



Pr int 



Pulse 



Read 



Remove 



Reset 



An event or process 
interrupt 



$DEBU6 



Map of <^963 alternate 
sectors 



$DASDI 



A digital output address $IOTEST 



Character image table 

from 4978 
Analog input 
Program 

Digital i nput 
Digital i nput us i ng 
external sync 



$FqNT 

$IOTEST 

^UPDATE 

$UPDATEH 

$IOTEST 

eiOTEST 



Breakpoints/trace ranges $DEBUG 



Reorganize Indexed Access Method 
data set 



$IAMUT1 



COMMAND 



Graphics data base from 

on? volume to another $DIUTIL MD 
Tape forward or back $TAPEUT1 MT 



PA 
PATCH 



PF 



POST 



3,3 



PD 



GET 

AI 

RP 

RP 

DI 

XI 



Rename Member $DISKUT1 RE 

Displayprofile 

identification name $DIUTIL RE 



OFF 



Indexed Acpess Method 

ECHO mode $IAMUTl EC 

Indexed Access Method 

SE command parameters $IAMUT1 RE 



RO 



,^^>^ 

w 



o 
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ACTIVITY 



Save 



Send 



Set 



FUNCTION 



UTILITY 



A single line message 
to another terminal 



$TERMUT3 



Terminate Logging 



$LOG 



Test 



COMMAND 



Restore Assigned ^963 alternate 

sector $DASDI 3,2 

Disk volume from 

diskettes $MOVEVOL None 

Disk or d i skette 

volume from tape $TAPEUT1 RT 
A9 7^ printer to the 

standard character set $TERMUT2 RE 



Rewind Tape $TAPEUT1 MT 

Tape and place offline $TAPEUT1 MT 



A <4978 control store 

into a direct access 

data set $TERMUT2 SC 

Character image table $FONT SAVE 
Contents of hardware 

registers and main 

storage in disk or 

diskette data set $TRAP None 
Disk volume on diskettes $MOVEVOL None 
Disk or diskette volumes 

on tape $TAPEUT1 ST 

Formatted screen image 

on disk $IMAGE SAVE 



None 



Breakpoints/trace ranges $DEBUG AT 
Indexed Access Method 

ECHO mode $IAMUT1 EC 
Indexed Access Method 

SE command parameters $IAMUT1 SE 

Tape offline $TAPEUT1 MT 



$LGGTERM 



Generated report or 

graph i c display 

profile member $DICOMP TD 

Process interrupt for 

occurrence of an event $IOTEST PI,SG,SB 
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Uti li ties 



ACTIVITY 


FUNCTION 


UTILITY 


COMMAND 


Unload 


Indexed Access Method 
data set 


$IAMUT1 


UN 


Ver i f y 


Readability of disk or 

diskette data set 
Tape executing correctly 
Tape surface free of 
defects 


$INITDSK 
$TAPEUT1 
$TAPEUT1 


V 

EX 

EX 


Write 


A hex value to a DO 

address 
Digital output using 

external sync 
Tapemark 


$IOTEST 

$IOTEST 
$TAPEUT1 


DO 

XO 

MT 



ff 



>^ 
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$COriPRES 
SCOMPRES - COMPRESS LIBRARY 

$COMPRES compresses a library on disk or diskette. It is used 
so that new data sets can be allocated when a library is frag- 
mented (due to deletion of data sets). 

Cauti on; 

• Do not compress a library while it is being accessed. 

• You must IPL the system after using $COMPRES if the volume 
that was compressed contains the supervisor ($EDXNUC). 

The following is an example of using the $COMPRES utility. In 
response to the prompting message >» the $A operator command 
determines if another program is active and the $L operator 
command invokes the $COMPRES utility. 



^*\. 

vy 
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$COMPRES 



Example 



> $A 

PROGRAMS AT 08:14:19 
IN PARTITION #5 
NONE 

> $L 

PGMCNAME, VOLUME): SCOMPRES 
eCOMPRES UP, 14. 00, 35, LP=4C00 

COMPRESS SYSTEM LIBRARY 

NARNING! SHOULD BE RUN ONLY WHEN 

NO OTHER PROGRAMS ARE ACTIVE 

VOLUME LABEL = EDXOOl 

COMPRESS LIBRARY ON EDXOOl? Y 

$EDXNUC COPIED 



$INITIAL 

$UPDATE 

$COMPRES 

$DISKUT1 

$DISKUT2 

$COPY 



COPIED 
COPIED 
COPIED 
COPIED 
COPIED 
COPIED 



LIBRARY COMPRESSED 

ANOTHER VOLUME? N 
$COMPRES ENDED AT 14.05.03 



ff' 
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SCOPY - COPY DATA SET 



$COPY 



$COPY copies a disk or diskette data set* in part or in its 
entirety* to another disk or diskette data set. Source and tar- 
get data sets must have the same organization; the need not be 
on the same disk or diskette drive or volume. You can specify 
the number of records of the source data set to copy and the 
relative starting record in each data set to begin copying. 
All target data sets must have been preallocated using 
$DISKUT1. Partial copy is only permitted if the data set 
organization is of type DO (Direct Organization, see 
$DISKUT1) . 



Note : For any copying related to tape» see "$TAPEUT1 
Management" on page 311 



Tape 



$COPY Commands 



The commands ava i lable under $COPY are listed beloM. To display 
this list at your terminal* enter a question mark in response 
to the prompting message COMMAND (?)s. 



COMMAND (?): ? 

CD - COPY DATA SET 

CV - COPY VOLUME 

RE - COPY FROM BASIC EXCHANGE 

WE - COPY TO BASIC EXCHANGE 

(-CA~ WILL CANCEL) 
EN - END PROGRAM 
COMMAND (?): 



After the commands are displayed, you are again prompted with 
COMMAND (?)s. You respond with the command of your choice (for 
example , CD) . 

Absolute Record Copy 

An absolute record copying function is also provided as part of 
the Copy Data (CD) command. See the data set naming con- 
ventions in the System Gu i de for a description of the special 
data set names, $$EDXVOL and $$EDXLIB, which are used when 
doing absolute record and basic exchange copying. 
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$COPY 



Volume Copy 



y 



$COPY can be used to copy an entire disk or diskette volume for 
the purpose of creating new or backup volumes. See the System 
Gu i de for an explanation of disk and diskette organization. 

Basic Exchange Diskette Data Set Copy 

$COPY can be used to read a basic exchange data set from a 
diskette and write it to a disk data set* or write a disk data 
set to a basic exchange data set on diskette. All data sets must 
exist before the copy operation. Only one sided* 128-byte 
diskettes can be used. The Event Driven Executive recognizes 
only one volume on a diskette. 

$COPY prompts you for the name of the bas i c exchange volume. 
The volume specified must already be varied online. 



You are prompted for the diskette basic exchange data set name. 
If you use $DASDI to format and initialize the basic exchange 
header on the diskette^ a data set named DATA will be automat- 
ically allocated. If you use $INITDSK to initialze the volume 
directory, the data set name becomes EDXLIB. DATA consists of 
all the data tracks on the diskette. A record size of 128bytes 
mustbespecified. 

Notes : 



\.-.V 



1. Errors may occur if the diskettecontains uninitialized 
HDRls. Data on the diskette is read and written two sectors 
per I/O operation. 

2. The diskette data set accessed must start on an odd sector 
boundary . 

You can control the location in the disk data set where data is 
read or written by entering the starting and ending record num- 
bers when prompted for that information. 

The following error message is issued if the output data set is 
too small to accommodate the amount of data to be copied from 
theinputdataset. 



DATA SET TOO SMALL 



When the output data set is on disk or diskette, the end of data 
pointers are updated. 
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SCOPY 



Examples 

CD - Copy Entire Data Set 



COMMAND (?): CD 

SOURCE (NAME, VOLUME) : DATAFILl 

COPY ENTIRE DATA SET? Y 

TARGET (NAME, VOLUME) : DATAFILl , EDX002 

ARE ALL PARAMETERS CORRECT? Y 

COPY COMPLETE 

50 RECORDS COPIED 

COMMAND (?): 



CD - Copy Hhere Receiving Member Is Too Small 






COMMAND (?): CD 

SOURCE (NAME, VOLUME) : DATAFILl 
COPY ENTIRE DATA SET? Y 
TARGET (NAME, VOLUME) : DATAFIL2 

^^^TARGET DATA SET TOO SMALL^^^ 
^^^COPY REQUEST CANCE LLED^*?f 



Note: No data is copied in this case 
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$COPY 



CD - Copy A Partial Data Set 



COMMAND (?): CD 

SOURCE (NAME, VOLUME) : DATAFILl 

COPY ENTIRE DATA SET? N 

FIRST RECORD: 1 

LAST RECORD: 3 

TARGET (NAME, VOLUME) : DATAFIL2 

FIRST record: 1 

ARE ALL parameters CORRECT? Y 

COPY COMPLETE 

3 RECORDS COPIED 

COMMAND (?): 



CV - Copy A Diskette To A Backup Data Set On <^962 Disk 



COMMAND (?): CV 

COPY VOLUME 

ENTER SOURCE VOLUME: EDXOOl 

ENTER TARGET VOLUME: EDX002 

ENTER TARGET DATA SET NAME - BDXOOl 

ARE ALL PARAMETERS CORRECT? Y 

COPY COMPLETE 

9*^9 RECORDS COPIED 

COMMAND (?): 



ff "Ik 



The CV command copies the ent i re d i skette volume. Therefore the 
target data set on the 4962 disk must equal the diskette size in 
records; 949 records for Diskettel, 1924 records for 
Diskette2. Use $DISKUT1 to allocate the data set on the disk. 



o 
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RE - Copy A Basic Exchange Diskette Data Set To Disk 



COMMAND (?): RE 

SOURCE ($$EDXVOL, VOLUME) : $$EDXVOL, BASIC 
TARGET (NAME, VOLUME) : DATAFILl, EDX002 

SPECIFY START/END? Y/N : N 

ENTER BASIC EXCHANGE DATA SET NAME: DATA 
NUMBER OF RECORDS COPIED: 52 
COPY COMPLETED 

COMMAND (?): 



ME - Copy A Disk Data Set To A Basic Exchange Diskette 



COMMAND 


(?): WE 








SOURCE 


(NAME, VOLUME) : DATAFILl 


1EDXOO2 


SPECIFY 


START/END? Y/N: N 








TARGET 


($$EDXVOL, VOLUME) : 


$$EDXVOL, 


BASIC 


ENTER BASIC EXCHANGE DATA 


SET 


NAME: 


DATA 


COPY COMPLETED 








COMMAND 


(?): 
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$C0PYUT1 



$C0PYUT1 - COPY DATA SET WITH ALLOCATION 



$C0PYUT1 performs several related copy functions. These func- 
tions determine the size and organization of the sourcedata 
set to be copied? allocates a member on the target volume* and 
then copies the source member to the target member. 

C auti oni If a member already exists on the target volume* it is 
deleted* reallocated* and the new source copied to the target 
volume. There are no prompting messages asking if you wish to 
replace the existing member. 



Note t For any copying related to tape* see "$TAPEUT1 
Management" on page 311 



Tape 



$C0PYUT1 Commands 



The commands available under $C0PYUT1 are listed below. To dis- 
play this list at your terminal* enter a question mark in 
response to the prompting message COMMAND (?):. 



COMMAND (?): ? 



CM C 

CALL- 
CAD 

CAP 

CG 

CNG 

SQ 

NQ 

— CA — 

CV C 

EN E 

? H 



OPY M 
MULT 
COPY 
COPY 
COPY 
COPY 
COPY 
END 
SET P 
RESET 
WILL 
HANGE 
ND PR 
ELP 



EMBER FRO 

IPLE COPY 

ALL MEMBE 

DATA 

PROGR 

MEMBE 

MEMBE 

F MULTIPL 

ROMPT MOD 

PROMPT M 

CANCEL M 

SOURCE A 

OGRAM 



ALL 
ALL 
ALL 
ALL 



M SOURCE TO TARGET 

COMMANDS 

RS FROM SOURCE TO TARGET 

MEMBERS FROM SOURCE TO TARGET 

AMS FROM SOURCE TO TARGET 

RS S^rARTING WITH TEXT FROM ... 

RS NOT STARTING WITH TEXT FROM ... 

E COPY COMMANDS 

E FOR ALL MULTIPLE COPY COMMANDS 
ODE FOR ALL MULTIPLE COPY COMMANDS 
ULTIPLE COPY COMMANDS 
ND TARGET VOLUMES 



COMMAND (?): 



After the commands are displayed* you are again prompted with 
COMMAND (?).*. You respond with the command of your choice (for 
example * CM ) . 
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The following commands modify the way the multiple copy 
commands work; if needed* they must be entered before you start 
a multiple copy function. 

SQ You are asked if you want to copy the current member. 

NQ No questions are asked. All matched members are copied. 
This is the default. 

The following keyboard function is invoked with the ATTENTION 
key. (It is not a command.) 

CA If entered* CA stops the multiple copy after the current 
member i s cop i ed . 

Nhen $C0PYUT1 is loaded* the source and target volumes are set 
to the IPL volume. You can then change the source and target 
volumes. Once the volumes are set* the copy commands copy mem- 
bers from the source volume to the target volume until you do a 
CV to change a volume. 






The CG (copy generic) and CNG (copy not generic) commands 
prompt you for a text string. The source volume directory is 
then searched for names beginning with this text string. Use 
CG to copy only those members beginning with the text string. 
Use CNG to copy only those members that do not begin with the 
text string. 



If the multiple copy commands stop because the target volume is 
full* you can mount a new volume and continue the copy. Thus, 
you can create a disk backup spanning several diskettes. The 
actual copy process may take longer than with the utility 
$MOVEVOL* but may use fewer diskettes as only members are 
copied. In addition* single and double-sided diskettes can be 
i ntermi xed . 

Since $C0PYUT1 deletes a member if it already exists* the mul- 
tiple copy functions run faster if the target volume does not 
contain the same member names. If you are creating a new vol- 
ume* use $INITDSK to start with an empty target volume. 

The multiple copy commands will not copy the supervisor 
($EDXNUC). This prevents the inadvertent loss of a tailored 
supervisor. Furthermore* since the supervisor is allocated 
when the disk is initialized* the CM command will not allocate 
$EDXNUC on the target volume. It will copy $EDXNUC from source 
to target but only if the size of $EDXNUC on the target is the 
same size as on the source. 
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SCOPYUTl 



No absblute record copy from disk or diskette is provided* 
therefore the special names $$* $$EDXLIB, $$EDXVOL are not 
allowed* The $CdPY utility provides an absolute copy by record 
number * 






O 
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Example 



SCOPYUTl 



> $L $C0PYUT1 

$C0PYUT1 35P, 11:16:57, LP= 6900 

^^ WARNING ^^ 
MEMBERS ON TARGET VOLUME WILL BE DELETED. 
REALLOCATION AND COPYING OF MEMBERS IS 
DEPENDENT ON SUFFICIENT CONTIGUOUS SPACE. 

THE DEFINED SOURCE VOLUME IS EDX003, OK ? Y 

THE DEFINED TARGET VOLUME IS EDX003, OK ? N 

ENTER NEW TARGET VOLUME: MIKES 

MEMBER WILL BE COPIED FROM EDX003 TO MIKES OK?: Y 

COMMAND (?): CM 

ENTER FROM(SOURCE) MEMBER: COFFEE 

ENTER TO (TARGET) MEMBER OR ^ FOR SAME NAME AS SOURCE:GO 

GO COPY COMPLETE ^ RECORDS COPIED 

COMMAND (?) : CM LEM M 

LEM COPY COMPLETE 10 RECORDS COPIED 

COMMAND (?): CG 



J 



ENTER GENERIC TEXT: MIKE 
MIKEEDIT COPY COMPLETE 
MIKEANL COPY COMPLETE 
MIKEDATA COPY COMPLETE 



5^ RECORDS COPIED 
13 RECORDS COPIED 
50 RECORDS COPIED 



MIKENAME TOO LARGE TO COPY, ONLY 92 RECORDS 
TARGET VOL IS FULL, DO YOU WISH TO CONT ON A 
MOUNT NEW VOLUME AND DO A $VARYON 
THEN ENTER ATTN RESTART TO CONTINUE COPY 

> $VARYON 2 
EDXOOl ONLINE 

> RESTART 



LEFT IN LIB 
NEW VOL?: Y 



THE DEFINED TARGET VOLUME 
VOLUME NOT MOUNTED 
ENTER NEW TARGET VOLUME: 
MIKEl COPY COMPLETE 
COMMAND(?): SQ 
COMMAND(?): CALL 
COPY TEMP ? Y 
TEMP COPY COMPLETE 
COPY EDITWORK ? N 
COPY DATAFILE ? Y 
DATAFILE COPY COMPLETE 
COMMAND (?): 



IS MIKES, OK ? Y 



EDXOOl 

100 RECORDS 



COPIED 



40 RECORDS COPIED 



110 RECORDS COPIED 
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$DASDI 

$DASDI - FORMAT DISK OR DISKETTE 

$DASDI initializes your ^962 or 4963 disk or formats diskettes 
on the <^96<+ or <^966 diskette units. The utility can be used 
online. Nhen this utility is invoked, you are prompted for one 
of the following disk or diskette initialization option?: 

• Option 1 - 4964, 4966 diskette initialization. 

• Option 2 - 4962 disk initialization 

• Option 3 - 4963 disk initialization 

$DASDI must be loaded into partition 1. 

Caut 1 on » For disk initialization, a program that accesses the 
disk being initialized should not be run concurrently with this 
utility. 

Diskette initialization can run concurrently with other pro- 
grams . 



Option 1 - 4964* 4966 Diskette Initialization 






D iskette Formats 



The $DASDI utility reformats single and double-sided 
diskettes. Three formats are available: 

1. Format for use with the Series/1 Event Driven Executive 

2. Format to the IBM Standard for Information Interchange 

3. Format entire diskette to 128, 256, or 512 byte records. 

If you select the Event Driven Executive format, all tracks are 
formatted for 128 byte sectors. Also, cylinder is formatted 
according to the IBM Standard for Information Interchange. The 
assigned volume label is IBMEDX. 

Note : Use this format if all cylinders are to be formatted to 
128-byte sectors. 

If you initialize according to the IBM Standard for Information 
Interchange, Cylinder is formatted for 128-byte sectors, and 
the remaining cylinders are formatted for either 128-, 256-, or 



^kixJ*^ 
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$DASDI 



512-byte records. You are asked to select the desired 
The assigned volume label is IBMEDX. 



s 1 ze 



When you initialize according to sector size» all cylinders are 
formatted to the size you select (128-> 256-> or 512-bytes). No 
volume labels* headers, or deleted records are written on 
Cyl i nder . 

Cauti on? In this format, the diskette is not usable on an Event 
Driven Executive system except for reformatting. 



Operating Characteristics 



You are asked to identify the diskette drive by device address. 
The selected diskette drive is varied offline and a warning 
message issued to you before proceeding. On a <+966, diskette 
initialization can be performed only on slot 1. You are then 
prompted to select the options desired. Completion of the 
reformatting is indicated by the displayed messages: 



^*^\ 
\i^' 



'IBMEDX VARIED ONLINE' 
•FORMATTING COMPLETE' 



In the process of reformatting, a new volume label (IBMEDX) is 
wr i tten . 

Cauti on ' Do not use $C to cancel formatting operation. Enter > 
$DASDI to force termination. 
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$DASDI 

Examples 

Format Diskette for Event Driven Executive 



o 



$DASDI 



15P, 00:28:55, LP- 7E00 



DIRECT ACCESS DEVICE INITIALIZATION 
DISK INITIALIZATION OPTIONS: 

1 =: ^964, ^966 DISKETTE INITIALIZATION 

2 = 4962 DISK INITIALIZATION 

3 = 4963 DISK INITIALIZATION 

4 = EXIT DISK INITIALIZATION 
ENTER DISK INITIALIZATION OPTION: 1 

X DISKETTE FORMATTING PROGRAM ^ 

^ IF FORMATTING IS IN PROGRESS, DO NOT * 

^ CANCEL ($C) THIS PROGRAM. INSTEAD, ^ 

^ ENTER ATTN/$DASDI TO FORCE TERMINATION, x 

ENTER DISKETTE ADDRESS IN HEX 12 

INITIALIZE FOR USAGE WITH THE EVENT DRIVEN EXECUTIVE? Y 

EDX VARIED OFFLINE 

^^ WARNING ^ii 
FORMATTING WILL DESTROY ALL DATA. CONTINUE? Y 

IBMEDX VARIED ONLINE 

FORMATTING COMPLETE 

LOAD $INITDSK? Y 

$INITDSK 16P, 00:30:16, LP= 8D00 

COMMAND (?) : I 

LIBRARY INITIALIZATION 

1=ENTER VOLUME LABEL 
2=ENTER DEVICE ADDRESS 
SELECT option: 2 

ENTER DEVICE ADDRESS IN HEX: 12 
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Format Diskette for Event Driven Executive (continued) 



y 



WRITE VOLUME LABEL? Y 

ENTER DESIRED VOLUME LABEL (1-6 CHARACTERS) EDX 

ENTER OWNER ID (1-1<^ CHARACTERS): FCS 

LABEL WRITTEN 

CREATE A DIRECTORY? Y 

HOW MANY RECORDS IN DIRECTORY? (2 - 120): 13 

MAXIMUM NO. OF MEMBERS = 102, OK? Y 
DO YOU WISH TO RESERVE SPACE FOR A NUCLEUS? Y 
ENTER MAXIMUM SIZE IN K-BYTES (16-64): 64 
DIRECTORY INITIALIZED 

WRITE IPL TEXT? Y 
IPL TEXT WRITTEN 

COMMAND (?): EN 

$INITDSK ENDED AT 00:31:10 

ANOTHER DISKETTE? N 

$DASDI ENDED AT 00:31:15 
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SDASDI 



F ormat Diskette to IBM Standards for Information Interchange 






ENTER DISKETTE ADDRESS IN HEX 02 

INITIALIZE FOR USAGE NITH THE. EVENT DRIVEN EXECUTIVE? N 

INITIALIZE TO STANDARDS FOR INFORMATION INTERCHANGE? Y 
SELECT SECTOR SIZE (1=128, 2=256, 3=512): 2 

NND002 VARIED OFFLINE 

x^ WARNING ^^ 
FORMATTING WILL DESTROY ALL DATA. CONTINUE? Y 

IBMEDX VARIED ONLINE 

FORMATTING COMPLETE 

ANOTHER DISKETTE? N 

$DASDI ENDED AT 00:^^^:30 



Format Diskette to 128-, 256-, or 512-Bvte Records 






ENTER DISKETTE ADDRESS IN HEX 02 

INITIALIZE FOR USAGE WITH THE EVENT DRIVEN EXECUTIVE? N 

INITIALIZE TO STANDARDS FOR INFORMATION INTERCHANGE? N 
SELECT SECTOR SIZE (1=128, 2=256, 3=512): 3 

^^ WARNING ^^ 
FORMATTING WILL DESTROY ALL DATA. CONTINUE? Y 

FORMATTING COMPLETE 

ANOTHER DISKETTE? N 

$DASDI ENDED AT 01:01:27 
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Option 2 - <»962 Disk Initialization 



$DASDI 



The disk initialization utility for the ^962 initializes your 
<;lisk» writes sector addresses on the entire volume* analyzes 
and locates defective sectors* and assigns alternate sectors. 
After initialization* the disk is ready for use with the Event 
Driven Executive. For a new disk device* initialization should 
be performed before the Event Driven Executive system is 
i nstal led on i t . 

When using this option* you are required to select one of two 
initialization types: 

• PI (primary) - initialize a disk for the first time or to 
completely reinitialize the disk. 

Cauti on? This option rewrites the complete disk surface 
and destroys all data that may have been on the disk. 

♦ AS (alternate sector assignment) - assign alternate sec- 
tors without destroying the data currently on the disk. 

Note : Use the AS option only when necessary. Cylinder 1 has a 
limited number of available alternate sectors. Once an alter- 
nate sector is assigned* it can only be recovered by writing 
all sector IDs during a primary initialization. 

The PI option verifies and corrects sector IDs and analyzes the 
disk surface to find defective sectors. If the programmer's 
console is present* the data buffer displays the number of the 



iv,y. rtiicii ail rtx\.vztii€i\.KZ act^i-ui 1:3 anaijrjiicu* (.iicr :3c:i^t.\jr xiy ui (.lie 

defective sector references the location of its alternate on 
Cylinder 1. Defective sectors are marked defective. Skewed IDs 
are written where normal IDs fail. For a defective sector on 
Cylinder 0* an alternate good sector under the same head 
Cylinder is reassigned to the defective sector. 



on 



The AS option forces the assignment of alternate sectors with- 
out destruction of data on the disk. $DASDI tries to move data 
from the defective sector to its assigned alternate. If data 
recovery fails, $DASDI issues a message and the alternate data 
field is flagged with one bits (hexadecimal FFFF). If an 
already assigned alternate is found defective* it is marked 
defective and a new alternate is assigned. Data recovery is 
attempted in this case also. 
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The number of alternate sectors available on Cylinder 1 depends 
on the 4962 model: 



Model 



Capac i ty 



Alternates 



1,1F,2,2F 
3,4 



9.3 MB 
13.9 MB 



120 
180 



1} 
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Examples 

Primary Initialization of a ^962 Disk 



$DASDI ISP, 00528:55, LP=7E00 

DIRECT ACCESS DEVICE INITIALIZATION 
DISK INITIALIZATION OPTIONS: 

1 = 496*^, ^966 DISKETTE INITIALIZATION 

2 = ^962 DISK INITIALIZATION 

3 = ^963 DISK INITIALIZATION 

4 = EXIT DISK INITIALIZATION 
ENTER DISK INITIALIZATION OPTION: 2 

^ WARNING * 

X NO USER PROGRAM SHOULD BE RUNNING ^ 

^ WHILE PERFORMING DISK INITIALIZATION x 

DISK INITIALIZATION STARTED 
ENTER DEVICE ADDRESS - NNN: 003 

ENTER INITIALIZATION TYPE - PI OR AS: PI 

ENTER INITIALIZATION MODE 

REMOVE PREVIOUS ... DEFECTIVE SECTOR FLAGS? Y|N: NO 



In the above example, you are prompted for the following: 

• Disk or diskette initialization option: 1, 2, or 3 

• Initialization type: PI for primary or AS for alternate 
sector 

• Initialization mode: 

NO - Retain defective flag byte of each sector ID. 

- YES - Rewrite sector flag IDs and reinitialize the flag 
byte where possible. Allows a disk with invalid sector 
flags to be initialized. 

Caution: Respond YES only if you wish to rewrite all sector 
IDs. This causes the loss of any IBM factory assigned defec- 
tive sector flags. If you respond YES, the following verify 
operationoccurs: 
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FACTORY MARKED DEFECTIVES MAY BE LOST 
IS CHANGE OF REPLY DESIRED? Y|N: NO 



#> 



mn 

y 



NO Operation is to continue with flags considered invalid. 

YES A reprotnpt of the previous message results* allowing you 
to change the status of the defective flags. 

The following message is repeated for each alternate sector 
assignment* if any occur: 



ALTERNATE SECTOR ASSIGNED FOR ccchss 



Note i ccchss=:the address of the alternate sector assigned. 
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Alternate Sector Assignment on a <^962 Disk 



o 



$DASDI ISP, 00:28:55, LP=7E00 

DIRECT ACCESS DEVICE INITIALIZATION 
DISK INITIALIZATION OPTIONS: 

1 = 496<^, ^966 DISKETTE INITIALIZATION 

2 = A962 DISK INITIALIZATION 

3 = '^963 DISK INITIALIZATION 
<+ = EXIT DISK INITIALIZATION 

ENTER DISK INITIALIZATION OPTION: 2 

* WARNING ^ 

¥r NO USER PROGRAM SHOULD BE RUNNING ^ 

^ WHILE PERFORMING DISK INITIALIZATION ^ 

DISK INITIALIZATION STARTED 
ENTER DEVICE ADDRESS - NNN: 003 



ENTER INITIALIZATION TYPE 



PI OR AS: AS 



ALTERNATE SECTOR MODE 
ENTER SECTOR ADDRESS 



CCCHSS 



The following message is displayed at your terminal indicating 
completion of the disk initialization. 



ALTERNATE SECTOR ASSIGNED FOR CCCHSS 
DISK INITIALIZATION COMPLETE 



$DA5DI 



ENDED AT 00:31:15 



ccchss : The address of the sector presumed to be defective. The 
utility assigns an alternate sector on Cylinder 1, then tries 
to move the data from the defective sector to the alternate 
sector. Alternates on Cylinder are located on the same track 
and head as the defects on Cylinder 0. This process may reveal 
that the sector IDs on Cylinder are in an inconsistent condi- 
tion. Processing continues if possible. You cannot assign an 
alternate to a defective sector on Cylinder 1. 
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Note i The fixed head area Is always referred to as Cylinder 
303. You should consider that this cylinder contains eight 
heads (zero through seven). To refer to sector five under fixed 
head four, you would specify 303^05 for ccchss. 



Option 3 - ^963 Disk Initialization 



The $DASDI utility program identifies and restores defective 
sectors on a «^963 disk device. The <+963 comes from the factory 
already formatted with all logical sector addresses assigned 
and tested and with alternates assigned to any defective sec- 
tors; you do not have to initialize a newly installed 4963. 

With this function, you are given the option of: 

• Identifying a specific sector as being defective, causing 
the utility to assign an alternate to it. 

• Restoring a previously identified defective sector, caus- 
ing the utility to free its alternate. 



Printing a map of all defective sectors, indicating if the 
defective sector was factory or user identified. 



^> 



Alternate sectors are assigned as follows: 

• If the primary alternate (the extra sector on the same 
track) is available, it is used as the alternate for the 
defective sector. 

• If the primary alternate is not available (either it is 
defective or already assigned), a secondary alternate is 
assigned from the nearest track under the movable heads 
having an available primary alternate. 

N ote : The primary alternate under a fixed head is assigned to a 
sectorthatis under the same fixed head. 

When restoring sectors from defective status, $DASDI phys- 
ically moves the sectors within the track to minimize the proc- 
essing time between consecutive logical sectors. You cannot 
restore : 

• A factory assigned defective sector 

• A primary defect (one that cause the primary alternate 
sector for the track to be assigned) 
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• A sector Nhose ID has been written extende<;l 

Examples 

Invoking A963 Disk Initialization 






$DASDI ISP, 00:28:55, LP»7E00 

DIRECT ACCESS DEVICE INITIALIZATION 
DISK INITIALIZATION OPTIONS: 

1 = ^964, 4966 DISKETTE INITIALIZATION 

2 = 4962 DISK INITIALIZATION 

3 = 4963 DISK INITIALIZATION 

4 = EXIT DISK INITIALIZATION 
ENTER DISK INITIALIZATION OPTION: 3 

^ WARNING »« 

* NO USER PROGRAM SHOULD BE RUNNING ?f 

^ WHILE PERFORMING DISK INITIALIZATION ^ 

DISK INITIALIZATION STARTED 
ENTER DEVICE ADDRESS - NNN: 048 

THE AVAILABLE OPTIONS ARE: 

1 - IDENTIFY DEFECTIVE SECTOR(S) 

2 - RESTORE DEFECTIVE SECTOR(S) 

3 - MAP DEFECTIVE SECTOR(S) 

4 - EXIT UTILITY 



ENTER OPTION: n 



The entry n must be one of the four options listed in the coin 
mand menu. You can choose to identify, restore, or map defec- 
tive sectors. The utility terminates when you enter Option 4. 
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Obtaining Map of Defective ^963 Sectors 



:> 



ENTER OPTION: 3 

DEFECT ALTERNATE 

000101 

02011^^ 



EXTENDED 



Assigning an Alternate Sector 



ENTER OPTION: 1 

ENTER CCCHHSS OF SECTOR TO BE MARKED 
DEFECTIVE OR END: 0010205 

ENTER »Y' TO ASSIGN ALTERNATE, 
ANYTHING ELSE TO CANCEL: Y 

ccchhss ASSIGNED ALTERNATE OF 0010205 

ENTER CCCHHSS OF SECTOR TO BE MARKED 
DEFECTIVE OR END: END 

ENTER OPTION: 






Note: In the preceding example, the disk address for a ^963 is 
entered as a seven-digit number (0010205): the cylinder is 1 
(001), the head is 2 (02), and the sector is 5 (05). 
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Restoring a Prcv iQUsly Ass 1 oned Alternate Sector 



ENTER OPTION: 2 

ENTER CCCHHSS OF SECTOR TO BE 
RESTORED OR END: 0010207 

0010207 HAS BEEN RESTORED FROM ccchhss 

ENTER CCCHHSS OF SECTOR TO BE 
RESTORED OR END: END 

ENTER OPTION: 4 

DISK INITIALIZATION ENDED 

$DASDI ENDED AT OJ :0l:27 
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SDEBUG - DEBUGGING TOOL 



$DEBUG is a tool for locating errors in programs. By operating 
a program under control of $DEBUG» you can: 

• Stop the program each time execution reaches any of one or 
more instruction addresses that you have specified. These 
addresses are known as breakpoints. 

• List the contents of specified storage locations or regis- 
ter contents each time the program execution reaches one or 
more of your breakpoints. 



Trace the flow of execution of instructions within the pro- 
gram by specifying one or more ranges of instruction 
addresses Cknown as trace ranges). Each time the program 
executes an instruction within any of the specified trace 
ranges* the terminal displays a message identifying the 
task name and the instruction address just executed. 
Optionally, program execution can be stopped after each 
instruction is executed within a trace range. Also, 
optionally, storage locations or register contents can be 
displayed on the terminal after the execution of each 
instruction within a trace range. 

Restart program execution at the breakpoint or trace range 
address where it is currently stopped. Or, in the case of 
Event Driven Language instructions, restart program exe- 
cution at other than the next instruction. 






List additional registers and storage location contents 
while the program is stopped at a breakpoint or at an 
instruction within a trace range. 

Patch the contents of storage locations and registers. 



Using these functions, you can determine the results of compu- 
tations performed by the program and the sequence of 
instruction execution within the program. You can also modify 
data or instructions of the program during execution. 

To use $DEBUG effectively, you must have a printed listing of 
the program to be debugged which shows the storage addresses of 
each instruction and data area of interest. To obtain such a 
listing, specify PRINT GEN in the source program, after the 
PROGRAM statement, at assembly time. A PRINT NOGEN should pre- 
cede the PROGRAM statement to prevent the unnecessary printing 
of many system EQU statements, etc. For $EDXASM a satisfactory 
listing is produced by specifying LIST. 
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Debug Usage Considerations 



The program debug facility aids in testing mult i tasked 
programs in a multiprogramming and multiuser environment. All 
of your interactions are via terminals and do not require the 
use of the machine console* A summary of the major features of 
the $DEBUG program follows: 

Notes i 

1. $DEBUG should be invoked from a terminal other than the one 
used by the program to be tested if the program uses 
^978/^979 terminals in STATIC screen mode. 

2. Multiple breakpoints and trace ranges can be established. 

3. Several users can each use separate copies of $DEBUG con- 
currently* if sufficient storage is available. 

^. Series/1 assembler language as Mell as Event Driven 
Language instructions can be traced and tested. 






\ 



5, Both supervisor and application programs can be debugged. 

6. Task names are automatically obtained from the program to 
be tested . 



7. Task registers #1 and #2 can be displ,ayed and modified. 

8. Hardware registers RO through R7 and the lAR can be 
displayed and modified. 

9. Five different data formats are accepted by the list and 
patch f unct i ons . 

10. No special preprocessing of a program is required to permit 
i t to be debugged . 

11. All address specifications are made as shown in the program 
assembly listing without concern for the actual memory 
addresses where the program is loaded into storage for 
test i ng . 

12. No processing overhead is incurred unless the hardware 
trace feature is enabled. Even then* the hardware trace 
feature is only enabled for specific tasks. 

13. The debug facility can be activated for a program that is 
experiencing problems but was previously loaded without 
the debug facility. 
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14. A program can be debugged by loading $DEBUG from a terminal 
other than the one from which the program to be tested was 
loaded . 

15. Breakpoints or trace ranges specified during a debug ses- 
s i on can be 1 i sted . 

16. $DEBUG can only control the execution of programs contain- 
ing no more than 20 tasks. 

The $DEBUG program can be used to test different types of 
programs. The most common usage is to debug application 
programs written using the Event Driven Language instruction 
set. However* it can also be used to test portions of applica- 
tion programs that are written in assembler language and 
portions of the supervisor program that are written in either 
Event Driven Language or Series/1 assembler language. Testing 
of the supervisor should normally be required only if you are 
making your own modifications or additions to this program. 



You can use $DEBUG to debug overlay programs by loading the 
primary program that will subsequently load the overlay pro- 
gram to be debugged. Load $DEBUG after the overlay program is 
in storage. (For more information on debugging overlay pro- 
grams that are part of the Event Driven Language compiler* 
$EDXASM» refer to the Internal Design ). To suspend execution of 
the overlay program so that $DEBUG can be loaded, enter a 
READTEXT or QUESTION as the first instruction of the overlay 
program. Mul t i p le Termi na 1 Manager users should code a CALL 
ACTION instruction to provide the required function. When the 
overlay program is entered, it pauses at the first instruction 
and waits for input. At this point, load $DEBUG. This can be 
done from another terminal assigned to the same partition. 
Specify the overlay program name when prompted for the program 
name and indicate that no new copy of the overlay program is to 
be loaded . 



,4 \ 



The $DEBUG utility can then be used to set breakpoints and 
perform other functions as required. If the overlay program 
causes a program check, it is cancelled by the system. If an 
overlay program terminates through a PROG STOP or for any other 
reason and is reloaded by the primary program, any breakpoints 
or patches made prior to the termination are lost. 

Use of certain capabilities of $DEBUG requires a thorough know- 
ledge of both the supervisor and debugging techniques. For 
example, altering the contents of storage locations occupied 
by the supervisor or contents of the Series/ 1 hardware regis- 
ters could have undesirable effects on the operation of the 
supervisor or application programs in operation concurrently 
with $DEBUG. 
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Note ? Only those instructions that execute as part of a task 
canbe debugged. Those portions of the supervisor program that 
service interrupts created by various hardware devices (disk* 
timers, terminals, etc) cannot be executed under control of 
$DEBUG. 



Start and Termination Procedure 



The primary method for activating the debug facility is to load 
$DEBUG and then specify the name of the program to be tested, 
when prompted (DBUGDEMO in the following example). $DEBUG then 
loads your program, inserts a breakpoint at the first executa- 
ble instruction, and notifies you that your program is stopped 
at this point. For example? 






> $L SDEBUG 

$DEBUG 26P, 09:10:17, LP=5200 

PROGRAM NAME: DBUGDEMO 

DBUGDEMO -^P , 09 : 1 : 28 , LP=6700 

DBUGDEMO STOPPED AT 009E 
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SDEBUG Commands 



The follouiing commands are available* 



AT - Set breakpoints and trace ranges 

BP - List breakpoints and trace ranges 

thus far specified 

END - Terminate debug facility 

GO -■ Act i vate stopped task 

GOTO - Change execution sequence 

HELP - List debug commands 

LIST - Display storage or registers 

OFF - Remove breakpoints and trace ranges 

PATCH - Modify storage or registers 

POST - Post an event or process interrupt 

QUALIFY - Modify base address 

WHERE - Display status of all tasks 



Command Entry 



A command is entered by pressing the ATTENTION key on your ter- 
minal and entering the command name* or the command name plus 
the required parameters for the command* in response to the 
prompting message '>*. 



Syntax Summary 



In the command syntax examples and descriptions in the follow- 
ing sections, keyword parameters are capitalized and variable 
parameters are shown in lower case. Whenever one of several 
keywords can be chosen, these keywords are separated by a 
slashC/). The examples show the various formats of each com- 
mand which are available for different purposes. Detailed syn- 



tax descriptions 
Descr i pt i ons . 



are presented under $DEBUG Command 



■A 
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Set breakpoints and trace ranges: 

AT ADDR address NOLIST/LIST NOSTOP/STOP 

AT TASK taskname start-add end-add EDX/ASM NOLIST/LIST 

NOSTOP/STOP 
AT ALL NOLIST/LIST NOSTOP/STOP 
AT ^ NOLIST/LIST NOSTOP/STOP 

Terminate $DEBUG.* 

END 

Activate breakpoints or trace ranges: 

GO ADDR address 

GO TASK taskname start-add end-add 

GO ALL 

GO ^ 



^^ 



List $DEBUG commands: 
HELP 



Display storage or registers: 



LIST ADDR 

LIST RO. . .R7 

LIST #l/#2 

LIST lAR 

LIST J( 



address length mode 

taskname length mode 

taskname length mode 

taskname length mode 



Remove breakpoints or trace ranges: 

OFF ADDR address 

OFF TASK taskname start-add end-add 

OFF ALL 

OFF K 
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Modify storage or registers: 

PATCH ADDR address length mode 

PATCH R0...R7 taskname length mode 

PATCH #l/#2 taskname length mode 

PATCH lAR taskname length mode 
PATCH ^ 



Post events or process interrupts? 

POST ADDR address code 

POST PIxx code 

POST ^ 



Modify base address! 

QUALIFY base disp 
Q base displ 



Display status of all tasks: 
WHERE 



Display breakpoints and trace ranges 
BP 



Change execution sequence: 

GOTO current-address new-address 
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Example: The command syntax permits most keyword 
be abbreviated to a single character* excep 
conflicts with ADDR; entry of AL for ALL and A fo 
mitted. You are prompted for command parameters 
unless you are sufficiently familiar with the syn 
complete command on a single line. For example, t 
TIMET into a program trace between addresses 
also print the contents of both task registers in 
decimal mode but continue processing* the folio 
tive keyboard sequence may occur. Each response 
by a RETURN key entry. 



$DEBU6 



parameters to 
t ALL which 
r ADDR i s per- 
indivi dually* 
tax to enter a 
o set the task 
and 3000 and 

task L00P2 in 
wing i nterac- 

i s termi nated 



> AT 




OPTION(x/ADDR/TASK/ALL) : TASK 


TASK NAME: TIMET 




FIRST ADDRESS: 




LAST address: 3000 




TRACE TYPECEDX/ASM) : 


EDX 


LIST/NOLIST: LIST 




OPTION(^/ADDR/RO. . .R7/#l/#2/IAR) : »1 


TASK NAME: L00P2 




length: 2 




M0DE(X/F/D/A/C) : F 




STOP/NOSTOP: NOSTOP 




1 BREAKPOINT(S) 


SET 



Ident i cal 
response : 



results are obtained by entering the single 



> AT T TIMET 3000 E L »1 L00P2 2 F N 
1 BREAKPOINT(S) SET 
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SDEBUG Command Descriptions 



AT - Set Breakpoints and Trace Ranges 

AT sets breakpoints and trace ranges. The LIST and STOP options 
established for a breakpoint or trace range are executed prior 
to executing the instruction that satisfied the breakpoint or 
trace range specification. When the specification for a break- 
point or trace range is satisfied, the task currently active is 
detoured and $DEBUG performs the following actions for the sub- 
ject task: prints its status, prints the LIST specification, 
and optionally puts the task into a wait state. If the NOSTOP 
option was requested, task status is printed as "taskname 
CHECKED AT XXXX". The STOP option generates a "taskname 
STOPPED AT XXXX" message. 

The LIST and STOP options for all currently defined breakpoints 
and trace ranges can be modified by entering AT ALL. Similar- 
ly, the specifications for the most recently entered AT command 
can be altered by the AT ^ option. 

Notes : 



1. You cannot set breakpoints in ATTNLIST routines. 

2. You can only set breakpoints on EDL instructions within an 
EDL program . 






Syntax 



AT ADDR address NOLIST/LIST NOSTOP/STOP 

AT TASK taskname start-add end-add EDX/ASM NOLIST/LIST 

NOSTOP/STOP 
AT ALL NOLIST/LIST NOSTOP/STOP 
AT * NOLIST/LIST NOSTOP/STOP 



Operands Descr i pt i on 

ADDR Keyword indicating this is an instruction program 
breakpoint specification. 



address Instruction address where a breakpoint is to be 
i nserted . 



^Imyaji^ 
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Caution: Be sure that this is the first word of an 
executable instruction* since the low-order byte of 
this word will be modified by $DEBUG. Unpredict- 
able results can occur if you specify the address of 
data or the address of other than the first word 
generated by an i niitruct i on . 



NOLIST No special print request is needed at this break- 
point or trace range. 



LIST 



Complete specification for a storage or register 
display. See the LIST command for a description of 
all list options and parameters. 



NOSTOP Processing is to continue after the breakpoint 
notification has occurred. 



STOP 



The task is to stop whenever this breakpoint or 
trace range specification is satisfied. 






TASK Trace range spec i f i cat i on . 

taskname Name of task to be traced. If the program contains 
only one task* omit this parameter. 

start-add Trace range starting address. Since your program 
is not actually modified by a trace specification* 
no specidl care needs to be exercised in entering 
trace addresses . 



end-add Trace range ending address. To establish a 
breakpoint at an individual assembler instruction* 
specify both the starting and ending address to 
coincide with the instruction address. 



EDX 



Only Event Driven Language instructions are to be 
traced . 



ASM 



ALL 



All Series/1 assembler instructions 
specified range are to be traced. 



within the 



All currently defined breakpoints and trace ranges 
are redefined with new list and stop options. 

The most recently defined breakpoint or trace range 
specification is to be redefined. This specifica- 
tion is determined by the last usage of an AT, GO, 
or OFF command . 
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BP - List Breakpoints and Trace Ranges 



BP displays all breakpoints and trace ranges that have been 
specified during the current debug session. The information 
supplied for each breakpoint includes the task address* 
instruction type* associated list options* and whether a stop 
was spec i f i ed . 

Syntax 



BP 



No operands are required. 



END - Terminate $DEBUG 



END removes all currently active breakpoints and trace ranges* 
activates all currently stopped tasks* and terminates $DEBUG. 

Syntax 



■<J 




No operands are required. 



\^ 
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GO - Activate a Stopped Task 

GO reactivates any task that has been stopped by $DEBUG. If a 
task is stopped at a breakpoint, specify the exact breakpoint 
address. If a task is stopped as a result of a trace specifica- 
tion, supply the name of the task and an address range which 
brackets the addresses in the original trace request. If only 
one task is being debugged, no operands need be specified. 

Syntax 



GO ADDR address 

GO TASK taskname start-add end-add 

GO ALL 

GO ¥: 

GO 



*"\ 



Operands 
ADDR 

address 
TASK 

taskname 



Description 

Keyword indicating 
specification. 



this 



1 s 



breakpo i nt 



Instruction address where the task is, stopped. 

Keyword indicating this is a trace range 
specification. 

Name of task to be activated. For programs contain- 
ing only a single task, omit this parameter. 



start-add Trace range starting address. 

end-add Trace range ending address. 

ALL All currently stopped tasks are to be activated. 

^ The most recently referenced breakpoint or trace 

range specification is to be used. This specifica- 
tion is determined by the last uf^a'ge of an AT, GO, 
or OFF command . 
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GOTO - Change Execution Sequence 

GOTO reactivates* at a different instruction* any task that has 
been stopped at an Event Driven Language instruction. If 
stopped using a breakpoint or trace* supply the current address 
and the address at which execution should be resumed. Break- 
point or trace specifications are not changed. 

Syntax 



o 




Operands Descr i Pt i on 
current-address 

Address where the task is stopped, 
new-address Address where execution is to be restarted. 

HELP -- List SDEBUG Commands 

The HELP command produces a list of $DEBUG commands and func 
t i ons . 

Syntax 







No operands are required. 



^«,t..a<>*^ 
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LIST - Display Storage or Registers 



LIST displays the contents of memory locations^ or task regis- 
ters* or hardware registers* or the lAR. The LSB can be dis- 
played by listing the lAR with a length of 11 words. Any 
register data is only guaranteed to be current if the corre- 
sponding task is inactive or stopped by a $DEBUG breakpoint or 
trace range. To repeat the most recently specified LIST 
command or to verify (list) a patch you have just entered* use 
"LIST ^". 

Syntax 



LIST ADDR address length mode 

LIST R0/.,./R7 taskname length mode 

LIST tl/#2 taskname length mode 

LIST lAR taskname length mode 

LIST * 






Operands Descr i pt i on 

ADDR Keyword indicating this is a display of a storage 
location. 



address Address of the storage location to be displayed. 

length Length of display in words* doublewords* or 
characters . depending on mode. 



mode 



Mode of data display: 



X - hexadecimal word 

F - decimal number(word) 

D - decimal number ( doubleword ) 

A - relocatable address 

C - EBCDIC character 

R0/.../R7 One of the Series/1 hardware registers RO through 
R7, To define the start of the LIST. 

taskname Name of task from which register data is to be 
displayed. For programs containing only a single 
task* omit this parameter. 



#l/#2 



Task register #1 or #2 specification. 
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lAR 



Keyword indicating the lAfe 
Register) is to be displayed 



(Instruction Address 



The most recently specified LiSt specification is 
to be used. This is determined by the last usage of 
a LIST or PATCH command* 



-1 J 
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OFF - Remove Breakpoints and Trace Ranges 

OFF removes a breakpoint or trace range established with the AT 
command. To remove a breakpoint* specify the exact breakpoint 
address. To remove a trace request* specify the name of the 
task and an address range which brackets the addresses in the 
original trace request. If a task is currently stopped at the 
requested breakpoint or trace range* this task is automat- 
ically reactivated. 

Syntax 



OFF ADDR address (breakpoints) 

OFF TASK taskname start-add end-add 

OFF ALL 

OFF ^ 



(trace ranges) 






Operands Descr i ot i on 

ADDR Keyword indicating this is the removal of the 
breakpoint specification. 

address Instruction address where a breakpoint has previ- 
ously been established. 

TASK Keyword indicating a trace range is to be removed, 

taskname Name of task associated with a trace range. For pro- 
grams containing only a single task* omit this 
parameter . 



start-add Trace range starting address. 

end-add Trace range ending address. 

ALL All breakpoints and trace ranges are to be removed. 

^ The most recently referenced breakpoint or trace 

range specification is to be used. This specifica- 
tion is determined by the last usage of an AT, GO, 
or OFF command . 



Chapter ^ , The Utilities 



97 



SDEBUG 



PATCH - Modify Storage or Registers 

PATCH modifies the contents of memory locations* task regis- 
ters, hardware registers* and the lAR (Instruction Address 
Register). The entire LSB (Level Status Block) can be modified 
by patching the lAR with a lengtli specification of 11 words. 
The patch to any register data is only guaranteed if the corre- 
sponding task is inactive or stopped by a $DEBUG breakpoint or 
trace range. To respecify the data for the most recent patch or 
to patch the data displayed by the most recent LIST command, 
enter 'PATCH ^ " . 

After the patch command is entered, the current memory or 
register content is displayed, and you are prompted for the 
patch data (a string of data entries that satisfy the length 
and mode specifications). The entries are separated by spaces, 
for example, data. ..data. After the patch data is entered, you 
can apply the patch by responding YES, abort by responding NO, 
or indicate additional patches with a CONTINUE reply to the 
prompting message. By specifying CONTINUE, the patch is 
performed and prompting continues for entry of new length, 
mode, and data specifications to memory or register locations 
immediately behind your previous patch. 

If less data than specified with the length operand is entered, 
the effective patch is padded with blanks for character data 
and zeros for all other data types. 

Syntax 



o 



PATCH ADDR address length mode 

PATCH R0/.../R7 taskname length mode 

PATCH #l/#2 taskname length mode 

PATCH lAR taskname length mode 

PATCH 5f 



Operands Descr i pt i on 

ADDR Keyword indicating this is a storage patch. 

address Address of the storage location to be modified, 

length Length of patch in words, doublewords> 
characters depending on mode. 



or 



^ku^ 
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mode 



Mode of data entry: 



$DEBUG 



X - hexadecimal word 

F - decimal number(word) 

D - decimal number (doub leword ) 

A - relocatable address 

C - EBCDIC character 

R0/.../R7 One of the Series/1 hardware registers RO through 
R7» where the patch is to be started, 

taskname Name of task for which register data is to be 
modified. For programs containing only a single 
tasky omit this parameter. 



#l/#2 
JAR 



Task register tl or #2 specification. 

Keyword indicating the lAR (Instruction Address 
Register) is to be modified. 






The most recently referenced LIST or PATCH specifi- 
cation is to be used. This is determined by the 
last usage of a LIST or PATCH command. 
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POST - Post an Event or Process Interrupt 

POST activates a task waiting for an event or a process inter- 
rupt. To duplicate a previous posting, enter POST ^. The 
address of the ECB (Event Control Block) to be posted is con- 
tained in the second word of a WAIT command as shown on a pro- 
gram assembly listing. Process interrupts can also be posted 
by name» using the PIxx option. 

Syntax 



POST ADDR address code 
POST PIxx code 

POST ¥: 



Operands Descr i ot i on 

ADDR The address of an ECB (Event Control Block). 

address ECB address to be posted. 

code Decimal code to be posted to the specified ECB. 

PIxx Name of process interrupt PIl to PI99. 

^ The most recently referenced ECB address or PIxx 
name and code specification is to be used. 
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QUALIFY - Modify Base Address 



QUALIFY modifies the base address used by $DEBUG to reference 
physical storage locations. This command is useful for debug- 
ging supervisor program modifications. 

Syntax 



QUALIFY base displ 
Q base displ 



Operands Description 

base New hexadecimal base address. Enter when working 
with the supervisor. 



displ 






Hexadecimal offset to be added to base to form the 
new base address for all subsequent address refer- 
ences. Enter the origin of the supervisor program 
module as shown on the link editor listing. 
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MHERE " Display Status of All Tasks 






WHERE displays the current status of each task. If a task is 
currently processing its breakpoint routine* it is marked 
CflECKED. If a task has been stopped by a breakpoint or trace 
request or if the main task has not yet been attached by $DEBUG> 
the task is marked STOPPED. In all other cases, each task is 
shown to be at the currently executing instruction, at the com- 
mand it will start executing when dispatched by the task super- 
visor, or at the last command executed prior to entering a wait 
state . 

Syntax 



WHERE 
WH 



No operands are required. 



ff 
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Tips and Techniques 



Additional breakpoints and trace ranges that are desired 
should usually be established before initiating program 
execution with a GO ALL command. At program load time all task 
names are obtained by $DEBUG> and the current status of each 
task can be requested by entering NHERE. For example: 



> WHERE 

DBUGDEMO 

USERT 

L00P3 

L00P2 

TIMET 



STOPPED 
AT 02EE 
AT 0230 
AT OICO 
AT 0124 



AT 009E 



i^ 



Actual task names are only available if the program is loaded 
by $DEBUG. If the program to be tested is already loaded and 
executing* task names have been destroyed* and artificial 
names are generated by $DEBUG by appending the relative address 
(in hexadecimal) of the TCB (task control block) to TASK. For 
example : 



> WHERE 






TASK0308 


AT 


OOBE 


TASK02A0 


AT 


0300 


TASK01E2 


AT 


0298 


TASK0172 


AT 


OICO 


TASK00D6 


AT 


0164 



If the program to be debugged has previously been loaded into 
storage multiple times* the load points of all currently active 
copies are listed, and you have the option to specify which 
copy you wish to debug. You also have the option to request a 
fresh copy of the same program to be loaded. For example: 
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> $L SDEBUG 

$DEBUG 21P, 09:37 
PROGRAM NAME: DBUGDEMO 
ALREADY ACTIVE AT 5200 
DO YOU WANT A NEW COPY 



17, LP=C200 



5600 5A00 

TO BE LOADED? 



N 



PROGRAM LOAD POINT: 5600 



or 



DO YOU WANT A NEW COPY TO BE LOADED? Y 
DBUGDEMO 4P, 09:38:02, LP=5E00 



When more than one disk/diskette drive is available, programs 
from a volume other than the IPL volume can be loaded. For exam- 
ple : 







Notes: 



$DEBUG is terminated by the command END. It cannot be ended 
by the supervisor utility function command $C. 

When $DEBUG is ended the program which was being tested 
under the control of $DEBUG remains in storage with all of 
its tasks active and operating. 
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SDICOMP - DISPLAY COMPOSER 



The composer allows you to add display profiles and modify 
existing display profiles. Through the use of interactive 
dialogue* the program guides you through the generation or 
alteration of a display profile. Because this program does not 
change the basic structure of the online data base* you can use 
it at the same time other functions are being performed. This 
program can be used to generate a portion of a new display pro- 
file. Then you can use $DIINTR to cause the partial display to 
be generated. If corrections or additions are necessary, you 
can then use $DICOMP to alter the display profile. These steps 
can be repeated until the desired results are obtained. 



Invoking SDICOMP 



To start execution of $DICOMP: 

1. Load the program $DICOMP specifying the appropriate data 
set name. $DIFILE, the online data set» or any other data 
set can be used. However, you should make sure that anoth- 
er user or program is not changing or using the same data 
set . 

2. The system responds with the program loaded message fol- 
lowed by : 



$DICOMP - DISPLAY DATA BASE COMPOSER 
COMMAND (?): 



$DICOMP Commands 



The commands available under $DICOMP are listed below. To dis- 
play this list at your terminal, enter a question mark in 
response to the prompting message COMMAND (?):. 
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COMMAND (?): ? 

AD - ADD A NEW MEMBER 

AL - ALTER EXISTING MEMBER 

EN - EXIT PROGRAM 

IN - INSERT OR DELETE DISPLAY 

PR - PRINT MEMBER FORMATTED 

TD - TEST DISPLAY 

COMMAND (?): 



ELEMENTS IN A MEMBER 



o 



After the commands are displayed, you are again prompted with 
COMMAND (?)t. You respond with the command of your choice (for 
example , AD) . 

AD - Add a New Member to Data Base 

Allows you to generate a new display profile. The display can 
be in either graphic or report form. You are prompted to enter 
a 1-8 character Display Profile name used by the Interpreter to 
retrieve the display. The next prompt message asks if a dis- 
play heading is desired. If so, a report display is assumed. 
If not, a graphic display is assumed and you are prompted to 
proceed with generating the display. You are also permitted to 
select the device to which the output from the Interpreter is 
to be routed . 

Report Display: if the response to the question IS THIS A 
GRAPHIC DISPLAY? is NO, you are prompted to enter the column 
headings desired. One line up to 132 characters is allowed. 
Following the entry of the column headings, you are prompted to 
enter the name of the print report data member. You are then 
prompted to enter the next command. 

Graphic Display: if a graphic display is desired, you should 
respond to the message IS THIS A GRAPHIC DISPLAY? by entering 
the character Y. The composer then asks if the display is to be 
a 3D object. If you respond with a character Y, then all fol- 
lowing references to X and Y values will also include the Z val- 
ue. The composer asks you to enter the values X, Y, and Z, if 3D 
object. They are used to position the first character of the 
display heading. You are then prompted with the request COMMAND 
(?):*. Subcommands should then be entered. 



o 






106 SC3^-0313 



o 



$DICOMP 



AL - Alter an Existing Member 



This function alloMS you to display each element of a display 
profile and make changes* using subcommands* provided the size 
of the element and the sequence of commands is not changed. 
This function is of great value during the trial and error 
period when you are generating a new display. You can generate 
a display using the AD function and display the results using 
the Interpreter. You are allowed to either start alteration at 
the beginning of the member and display each element in turn or 
or to skip to a specific element within it. Use the PR command 
to display the elements and their sequence numbers. As each 
element is displayed* you are questioned whether or not this 
element is to be altered. 



ALTER ENTRY? 



o 



Nhen Y is selected* you are prompted to reenter the element as 
described in the AD/Add Member/ section. When the end of the 
display profile is reached* the Composer is terminated and you 
can redisplay the profile to see if the corrections are satis- 
factory . 



o 



EN - Exit Program 

This function provides an immediate exit from the Composer. 

IN - Insert or Delete Elements in an Existing Member 

This function combines the facilities of the Alter and Add 
functions with the ability to delete individual display ele- 
ments. Because the Insert function creates a new member in the 
data base* the size and sequence of display elements can be 
changed . 

N ote J Use of the utility program to verify that sufficient 
space remains in the data base is recommended. By using the LA 
and ST functions* you can determine the size of the member to be 
modified and the remaining space in the data base. As 
described in the Alter function* the Composer displays each 
element in turn with the following questions asked: 
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KEEP ENTRY? 
DELETE ENTRY? 
ALTER ENTRY? 



i f 



If you elect to keep the entry, the Composer proceeds to the 
next element. If N is selected, the DELETE ENTRY? question is 
displayed. If N is entered, the ALTER ENTRY? question is dis- 
played. If Y is entered, the Composer proceeds with the alter- 
ation process as described in the AL function description. 

Following the Alteration function, control is returned to the 
Insert function and the process is repeated for the next ele- 
ment. If the element was not altered, you are prompted to 
insert a new subcommand. At this point, all the functions of 
the AD facility are available. You can add one display element 
after which control is returned to the Insert function where 
the previous element is redisplayed and the sequence is 
repeated . 

Again, as in the Alter function, you must step through each 
element in the Display Profile before completion. When the end 
is reached, the message END OF DATA - ISSUE SAVE OR ADD NEW COM- 
MANDS is displayed. The Composer then reverts to the Add func- 
tion and additional commands can be entered. 

Note i You must issue a Save command to terminate the Insert 
function. When the Save command is issued, the Composer 
deletes the old member and renames the newly built member with 
the old name. This procedure makes the modified version avail- 
able to the Interpreter. You are urged to use the utility to 
compress the data base following insert activity to prevent 
fragmentation of the data base and reclaim unused space. 

PR - Print Member Formatted 

Display on the terminal or printer the contents of a display 
profile member formatted in the same way as used by the Alter 
and Insert functions. This display is useful as an aid in main- 
taining display profiles. Routing to $SYSPRTR is allowed to 
provideahighspeedhardcopy. 

TD ~ Test Display as Currently Entered 

You are prompted for the name of a plot control member and then 
$DIINTR is invoked to generate the specified display after 
which control is returned to you to make alterations. 
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Composer Subcommands 



When adding* altering, or inserting elements in a member, 
subcommands are used. These are listed below and described on 
the following pages. When entered, subcommands are placed in 
or modify the member. The member can later be used by the 
interpreter to generate the desired display. The following 
subcommands are available! 



o 



AD - ADVANCE X,Y 

DI - DIRECT OUTPUT 

DR - DRAW A SYMBOL 

EN - EXIT PROGRAM 

EP - END DISPLAY 

HX - DISPLAY HEX WORDS 

IM -- INSERT MEMBER 

JP - JUMP TO ADDRESS 

JR - JUMP REFERENCE 

LB - DISPLAY CHARACTERS 

LI - DRAW A LINE TO X,Y 

LR - DRAW LINE RELATIVE 

MP - MOVE BEAM TO X,Y 

PC - PLOT CURVE ONLY 

PL - PLOT DATA 

RT - ACTIVATE REALTIME DATA MEMBER 

SA - SAVE ACCUMULATED DATA 

TD - DISPLAY TIME AND DATE 

VA - DISPLAY VARIABLE 



Most subcommands perform actions based on the X and Y coordi- 
nates of the viewing screen. It is important that you keep 
track of the current X and Y values as the display is developed. 
The suggested method to produce a graphic display is to first 
draw the display on graph paper and assign X and Y coordinates 
to the key nodes in the display. Then use this drawing as a 
guide to the generation of the display, keeping in mind the 
screen limits for the terminal to be used. The view area ofthe 
graphic terminals supported is shown in Figure 17 on page 110. 
Figure 18 on page 111 shows the space supported in 3D mode. 
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o 
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Figure 17. X>Y Coordinate Grid and Viewing Area 



\J 
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Figure 18. XfVtZ Coordinate Grid and Viewing Area 



AD - Advance X#Y 

Moves the beam position by the specified value. This could be 
helpful in displaying data with even spacing on the screen. 
After issuing a 'DR' command using a symbol* AD could advance 
the X»Y position to the next position without regard to the 
actual screen X»Y location. The limit for the specified X or Y 
value is plus or minus 512 units. If a 3D object is being 
defined, then the Z axis value is also requested. 
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DI - Direct Output 



Directs the resulting graphic output to appear at a terminal 
other than the one used to enter commands. The terminal name to 
be entered is the label of the TERMINAL statement used to 
describe the desired terminal. 

DR - Draw a Symbol 

Draws a predefined symbol. Several commonly used symbols have 
been provided. In specifying a symbol* you are prompted to 
enter the symbol number and the symbol modifier. These values 
are used by the Interpreter to generate the requested symbol. 
Some of the symbols require additional information. If 
required* you are prompted for this additional information. 
Valid symbol numbers are 1 through l*^. 

Symbol # = 1 Draw Fan Symbol Left Hand Format 



Modifier = Radius of fan body 

and opening on left side 

of fan. Must be a multiple of ^ 



= start and end 
pos i t i on . 



X»Y current 




\J 



Symbol # - 2 Draw Fan Symbol Right Hand Format 



Modifier = Radius of fan body 

and opening on right side 

of fan. Must be a multiple of ^ 



= start and end 
position. 



X»Y current 




^iiiau>-'^ 
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Symbol # = 3 Draw Damper Vertical 



Modifier = Number of damper pairs 

to be generated in the down direction. 

= start and end X>Y current position. 



40 Units Y 



r^ — n 

16 Units X 



Symbol t = '^ Draw Damper Horizontal 



^^""H, 



Modifier = Number of damper pairs 
to be generated to the right. 



= start and end 
position. 



X» Y current 




16 Units Y 



40 Units X 



Symbol » = 5 Draw a Hot Coil 



Modifier = Number of hot coil pairs 
to be generated in the down direction 



= start and end 
pos i t i on . 



X f Y current 



n 



n 



h — M 

12 Units X 



16 Units Y 
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Symbol # = 6 Draw a Cold Coil 



c 



Modifier = Number of double pairs 

to be generated in the down direction 



16 Units Y 



= start and end 
position. 



X,Y current 



h — M 

16 Units X 



Symbol # = 7 Draw a Filter Element 



Modifier = Number of elements 

to be generated in the down direction 

= start and end X,Y current position 




16 Units Y 



8 Units X 



^1, 



Symbol # = 8 Draw a Valve 




16 Units Y 



For 2-way valve 
Mod i f i er = 2 

For 3-way valve 
Mod i f i er = 3 



= start and end X>Y current position. 



32 Units X 




32 Units Y 
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Symbol # = 9 Draw An Arrow 




its Y 



16 Units X 



Mod i f i er = 

1 for left 

2 for right 

3 for up 

4 for down 



16 Units Y 



8 Units X |-^ 



= start and end X>Y current position. 



16 Units Y 



Symbol » = 10 Draw a Logic Block Right 



Modifier = Radius of Half Circle. 
Must be a multiple of <f . 

= start and end X,y current position 



2R 
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Symbol » = 11 Draw a Logic Block Left 



Modifier = Radius of half circle. 
Must be a multiple of 4. 

= start and end X»Y current position 




2R 



Symbol * = 12 Draw a Circle 



Modifier = Radius of Circle. 
Must be a multiple of 4. 

= start and end X»Y current position 







^iuui.^^ 
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Symbol * = 13 Draw An Arc Right 



Modifier = Radius of circle. 
Must be a multiple of ^. 

- s^art and end X,Y current position 



Note : This symbol requires 
additional values. 

1. Draw arc up or down. 
Enter zero for down or one 
for up . 

2. Number of Y units to draw arc. 
Must be a multiple of <+ . 



Note : This symbol always starts at X = and 
proceeds until the Y units have been exhausted 




Symbol # = 1<^ Draw An Arc Left 



Modifier = Radius of circle. 
Must be a multiple of <^ . 

= start and end. X>Y current 
pos i t i on . 



Note i See note under Symbol 13 for additional 
i nf ormat i on . 




EN - Exit Program 

Causes the Composer to be terminated without updating the 
Display Profile Data Base Directory. All data collected up to 
this point for this member is lost. 
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The preceding list of available subcommands are those that are 
available when using the AD function. These descriptions are 
also valid when using the AL Alter function or the IN Insert 
f unct i on . 

EP - End Di splay 

Specifies that the end of this section of the display has been 
reached. Normally* this command is followed by a SA (Save) 
command. However* this command can be useful if a jump 
zero/not zero causes the Interpreter to take alternate paths. 
You can use the EP command at the end of each of these paths 
instead of an unconditional jump to a common ending point. 

HX - Send Data 

Sends to the terminal up to 16 words of data without conver- 
sion. All bit patterns are valid; therefore* control or spe- 
cial data can be sent to the terminal. 

IM - Insert Member 



Combines display profile members to form one display. This 
allows you to conserve disk space* decrease time required to 
enter display profiles* and standardize display formats. For 
example* you can build a display profile member to represent a 
common background of a physical system or floor plan. Then* by 
defining another display profile member* superimpose on the 
background the variables that will make the display unique. 
Only one level of nesting is permitted. That is* a member 
inserted using the *IM' command cannot contain any *IM' 
commands. However* a primary member can include multiple 'IM* 
commands . 



^4 ^y 



JP - JumF> to Address 

Causes a change in the sequence of execution of subcommands. 
There are three types of Jump to Address subcommands that can 
be used. They are: 

• Jump Unconditional 

• Jump i f Zero 

• Jump i f Not Zero 



As described in the Display Variable command* the conditional 
jump commands are dependent on the use of the Realtime Data 
Member. If conditional jump is selected* then the jump is 
based on the current condition (zero/not zero) of the specified 
word and record. Jump Unconditional prompts you to enter a 
Jump to Reference. This reference is two characters and is" 
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resolved when a *JR' Jump Reference is defined. See the 'JR' 
command definition. If you select a conditional jump* prompt 
messages requesting word number and record number are issued. 
Following the definition of these two codes» you are requested 
to enter the Jump to Reference. The Jump to Reference for a 
Conditional Jump is the same as that of an unconditional Jump. 
The following example shows the use of the Jump command. 



Command sequence using Jump: 



MP 


X=200, Y=200 






JP 


Zero, WORD#=0, 


RECORDt = <^, 


JR = AA 


DR 


SYM=1, MOD=40 






JP 


JR = BB 






JR 


AA 






DR 


5YM=2, M0D=40 






JR 


BB 






EP 








SA 









J' 



The preceding example draws a fan symbol at 200,200 either 
right or left depending on the zero/not zero condition of the 
Realtime Data Member word 0, record ^, 



In the preceding sequence, the first JP causes a jump to JR AA 
if word of record 4 is zero. The second JP causes a jump to JR 
BB unconditionally. 

JR - Jump Reference 

Indicates to the Composer that this location in the command 
sequence is referred to in a JP command. As defined in the JP 
command, the location is defined by 2 characters. If these 
characters have already been used, an error message is dis- 
played. If the capacity of the JR table is exceeded, an error 
message is displayed. The capacity of the jump reference table 
-j-:5^^0 unique jump reference points for each display. 



LB - Display Characters 



Places a character string on the screen. It is not necessary to 
use an MP command to position the beam because this command 
allows specification of the location of first character. If a 
3D object is being defined, then X, Y, and Z values are 
requested. Up to 72 characters can be displayed. The ending 
X,Y position are 1 character position beyond the last character 
in the string. 
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LI " Draw a Line to XiY 



ij 



Draws a vector to the specified X and Y coordinates from wher 
ever the beam was left with the previous command. 



600- 
200- 



T" 
100 



Draw line to X' 



600 Y=600 
END X,Y 



600 



Line shown on screen 
Current pos i t i on 



When generating a 3D display, 
values BTB X, Y, and Z. 



3 values are required 



These 







Draw line to 



X = 600 

END 



Y = 600 
X,Y,Z 



Z = 600 
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LR - Draw Line Relative 

Draws a line relative to the current position. For example* 
you can» through the use of the 'MP*, "JP*, and 'JR* commands, 
position the beam at various current positions based on 
Realtime Data Member conditions. Then a series of lines can be 
drawn to form a symbol using the 'LR' command. This would have 
the effect of placing the symbol at various screen locations 
based on external conditions. The limits allowed for the X,Y 
values are plus or minus 512 units. If a 3D object is being 
defined, then the Z axis value is also requested. 

MP - Move Beam to X,Y 

Draws a dark vector to the specified X and Y coordinates. A 
dark vector is not visible and> therefore, results in moving 
the beam to the specified location. 






200- • 



Beam moved to 



X=100 
END 



100 



Y = 200 
X,Y 



Nothing shown on screen 
Current pos i t i on 



When generating a 3D display, 
values are X, Y and Z. 



3 values are required. These 
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100 _ 
_ 



■r 




100 



Beam moved 



to X=100 
END 



100 



Y=100 Z=100 

XfYtZ Current position 



PC - Plot Curve Only 




PL - Plot Data 

Formats the viewing area into a basic plotter. Options are 
provided for X and Y labels as well as X and Y grids. You are 
prompted to include the name of a plot curve data member. Refer 
to the "$DIUTIL Utility Program" in "$DIUTIL - Display Data 
Base Utility" on page 150 for information regarding the allo- 
cation and formatting of the plot curve data member. The 
sequence of questions to be answered for the PL command: 

1. Enter # of Y axis divisions 

To present a readable display, it is suggested that this 
value be under 20. However, if Y axis division values are 
bypassed (Step 7), then larger values are appropriate. Y 
axis divisions become unreadable when this value exceeds 
125. 

2. Enter # of X axis divisions 
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To present a readable display, it is suggested that this 
value be under ^0. However* if X axis division values are 
bypassed (Step 8), then larger values are appropriate. X 
axis divisions become unreadable when this value exceeds 
200. 



Vert i cal Grid? 

A Y answer causes the Composer to include commands to 
connect the X axis divisions (specified in 2 preceding) to 
the top of the viewing area. An N bypasses this feature. 






Hor i zontal Gr i d? 

A Y answer causes the Composer to include commands to 
connect the Y axis divisions specified in 1 preceding to 
the right side of the viewing area. An N bypasses this 
feature . 

Enter Y axis label - 2^ characters 

You must enter the Y axis label. If no axis label is 
desired, press the enter key. This label is general in 
nature and is placed at the left side of the viewing area. 
This label is vertical, that is, one character under the 
next . 

Enter X axis label - 24 characters 

You must enter the X axis label. If no X axis label is 
desired, press the enter key. This label is general in 
nature and is placed near the lower portion of the plot 
viewing area. 

Y axis division values? 

If Y axis division values are desired, respond with a Y. 
The Composer asks for as many values as you have specified 
divisions plus 1 (see Step 1 preceding). You must enter 6 
characters for each division. The first value requested is 
the value for the Y base line and each succeeding value is 
for the next division in the plus Y direction. 



X axis division values? 

If X axis division values are to be displayed, respond with 
a Y. The composer asks for as many values as you have spec- 
ified divisions plus 1 (see Step 2 preceding), 
enter 6 characters for each division. The 
requested is the value for the X base line and each 
succeeding value is for the next division in the plus X 
d i rect i on . 



You must 
first value 
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9, Enter Name of Member for Plot Data 



^ J/ 



Enter the name of a plot curve data member. This member 
must have been allocated and initialized by the use of the 
utility program $DIUTIL. Refer to "$DIUTIL Utility 
Program" in "$DIUTIL - Display Data Base Utility" on page 
150 for procedures on allocation and initializing of this 
member . 

10. Is This Plot a Point Plot? 

The composer allows the use of any valid printable charac- 
ter to be used for the plot. If Yes is selected^ then a 
plot character is requested. If N is selected* then a 
normal line for the curve is used. 

The preceding 10 steps generate the necessary commands to cause 
a basic plot background to be displayed and one curve to be 
superimposed on that background. If additional curves are 
desired* then 'PC commands should be issued next. 



RT ~ Activate Neu Realtime Data Member 

You can define multiple Realtime Data Members. This command 
allows you to switch from one to another during the generation 
of a Display. The default name for the realtime data member is 
'REALTIME'. 



.4" 



SA - Save Accumulated Data 

Specifies that completion of a display profile has been 
reached. The Composer enters the member name into the directo- 
ry of the display profile data base and make it available for 
the Interpreter. 

TD - Display Time and Date 

This command allows you to display the current time of day and 
date from the realtime clocks used by the Event Driven Execu- 
tive. You are reminded that prior to issuing a 'TD' command* a 
'MP' may be required to position the beam to the desired dis- 
play location. The 'TD' command displays the time and date in 
the following format? 



o 
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HH:MM:SS 


MM/DD/YY 


Mhere : 


HH Is 


Hours 




MM 


is Mi nutes 




SS 


is Seconds 




MM 


is Month 




DD 


i s Day 




YY 


1 s Year 






VA ~ Display Variable 

Places a data variable from the Realtime Data Member on the 
screen. A prompt message is issued asking if you wish to locate 
the data at a location other than the current X,Y position. If 
a 3D object is being defined* then X, Y» and Z are requested. 
The use of this command requires that the Realtime Data Member 
be allocated. The Composer continues by asking for the record 
number and word number. The record number is the record number 
within the Realtime Data Member. The word number is the word 
number within the record specified. This value is in the range 
of 0-8. 

The function code is requested next and is used to indicate the 
type of variable to be displayed. Valid function codes are as 
f ol lows : 



Single precision integer 

1 Double precision integer 

2 Standard precision floating point 

3 Extended precision floating point 
15 Character data 



Type code is requested next and is an indicator of the format of 
the value to be displayed. Valid type codes are: 
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Integer 

1 Floating point F format 

2 Floating point E format 



Field width and number of decimal places are requested next. 
If the variable is an integer* the number of decimals should be 
zero . 






o 
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$DIINTR 



The Interpreter program searches the data base and generates 
the requested display. Both graphic and report displays are 
generated in this manner. Each display profile is made up of 
many display profile elements. Each element* when retrieved 
from the data base by the Interpreter, is decoded and converted 
to the appropriate command to cause the requested action to be 
performed. Each display profile element contains various 
parts, such as Display Code, X and Y coordinates, Symbol ID, 
and Symbol Modifier. Realtime Data Member record number and 
Additional Member names are included in the display profile 
element . 

To begin operation of the Interpreter, you must first load 
$DIINTR. Output is directed to the terminal that requests the 
display or as directed by the Display Profile. The following 
steps are required to initiate the Processor Monitor: 

1. Load the program $DIINTR. 

2. The system responds with the prompt message: 




3. To terminate the Interpreter, enter "EXIT*. To cause the 
Interpreter to prepare the display, enter the Display ID. 



Using $DIINTR from an Application Program 



$DIINTR can be loaded from an application program to allow 
displays without operator assistance. The following example is 
the method used to cause this action to occur. 
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^ Your program 



LOAD $DIINTR,MBRNME,DS=($DIFILE),EVENT=#NAIT, 

LOGMSG=NO 
WAIT #WAIT 



MBRNME 


DATA 


CL8' 


DISPLAY' 


SI 


DATA 


F'O* 


THESE 8 VALUES ARE 


S2 


DATA 


F'O' 


X 


S3 


DATA 


F'O' 


^ 


D 


DATA 


F'0» 


¥: 


T 


DATA 


F'O' 


^ 


R 


DATA 


F'O' 


9e 


Dl 


DATA 


F»0* 


^ 


Tl 


DATA 


F'O* 


X 



FOR 3D OBJECTS 






When using $DIINTR to display a 3D object there are 8 values 
that are needed to describe the manner in which you want the 
object displayed. The preceding example shows the eight values 
passed to $DIINTR as follows: 



51 Platform Location X= 

52 Platform Location Y= 

53 Platform Location Z- 

D Platform Direction in Degrees 

T Platform Tilt in Degrees 

R Platform Rotate in Degrees 

Dl View Direction in Degrees 

Tl View Tilt in Degrees 



These values are single precision integers and may contain a 
numeric value from -32768 to +32767, 

Displaying 3D images requires a <^955 processor with floating 
point hardware installed. 



^kkic^J^ 
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SDIINTR 






3D objects can b6 defined by $DICOMP and placed on disk or 
diskette much the same as with a 2D object. The only difference 
is that each point in space has three values associated with it 
instead of 2. These three values represent the X, Y» and Z 
coordinates of the point in space. Figure 5-2 shows the limits 
of the defined area in space. The maximum limits of the defined 
areas in space are -32i768 to +32»767. You can define one or 
more objects within this cube. Once the object is defined, you 
can view this object from any location within the same space. 
To specify the location from where you wish to view the object* 
either pass these eight values through the use of the PARM= 
parameter in the LOAD instruction or $DIINTR requests this 
input if it is invoked by the $L command. The concept used to 
compute the 2D representation of a 3D object is as follows. The 
user is assumed to be suspended on a platform at a specific 
location in space. The first three values are the X, Y» and Z 
values that define the location in space of the vietaing plat- 
form. The next five values represent the physical orientation 
of the platform and the viewers orientation on that platform. 

Platform Direction in Degrees .' Assume the following unit vec- 
tor : 



2 


J 


Y 


4, 









If we rotate this unit vector in the direction Y to X around the 
Z axis, we can turn the view in any direction. A plus value 
causes, the unit vector to rotate clockwise as viewed from the 
+ Z axis to zero . 
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Platform Tilt in Deorees t Assume the following unit vector 



o 



2 

i 


7 

Y 



If we rotate this unit vector in the direction 2 to Y around the 
X axiSf we can tilt the view to any angle. A plus value causes 
the unit vector to rotate clockwise as viewed from the +X axis 
to zero . 



Platform Rotate in Degrees ? Assume the following unit vectors? 







If we rotate this unit vector in the direction Z to X around the 
Y axisy we can rotate the view to any angle. A plus value causes 
the unit vector to rotate clockwise as viewed from the -Y axis 
to zero. 



View Direction In Degrees : This value is used the same as the 
Platform Direction but is calculated after the above 3 are com- 
puted. This calculation rotates the unit vector in a Y to X 
direction around the Z axis with a plus value causing the unit 
vector to rotate clockwise as viewed from the +Z axis to zero. 
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View Tilt In Degrees : This value is used the same as the Plat- 
form Tilt but is calculated after the above 4 are computed. 
This calculation rotates the unit vector in a Z to X direction 
around the Y axis with a plus value causing the unit to rotate 
clockwise as viewed from the -Y axis to zero. 



Once the 8 values provided are computed* the object in space is 
converted to its 2D representation and sent to the terminal. 
It is possible to view an object with all or a portion outside 
the viewing area. Points and lines that do not fall within the 
viewing area are not shown on the 2D screen. The viewing area 
is shown in Figure 19 on page 132. 
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3D object in space 




2D object on screen 



Viewing screen 



•— ' Platform location 

Distance between platforhn location and viewing screen == 1 



k.,# 



Figure 19. Viewing Area in 3D Mode* 
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The folloMing example defines a 5D object in space 






A Cube 








CMD 


X 


Y 


z 


MP 


-100 


-100 


-100 


LI 


+ 100 


-100 


-100 


LI 


+ 100 


-100 


+ 100 


LI 


-100 


-100 


+ 100 


LI 


-100 


-100 


-100 


LI 


-100 


+ 100 


-100 


LI 


+ 100 


+ 100 


-100 


LI 


+ 100 


+ 100 


+ 100 


LI 


-100 


+ 100 


+ 100 


LI 


-100 


+ 100 


-100 


MP 


+ 100 


-100 


-100 


LI 


+ 100 


+ 100 


-100 


MP 


+ 100 


-100 


+ 100 


LI 


+ 100 


+ 100 


+ 100 


MP 


-100 


-100 


+ 100 


LI 


-100 


+ 100 


+ 100 


EP 








SA 









Object as vie 

51 

52 -^00 

53 
D 
T 
R 
Dl 
Tl 








wed from: 


\ X 










/ 




\ 
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Object as vieuied fromt 

51 -150 

52 -400 

53 
D 
T 
R 
Dl 
Tl 


^ 


' — ■ 


7 





Object as viewed from 



SI 
S2 
S3 

D 

T 

R 

Dl 

Tl 



-150 

-400 

100 





45 








.4f X 



o 
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allocate/delete; list directory data 



$DISKUT1 performs several commonly used disk or diskette stor- 
age management functions. 

Note : For tape management functions* see "$TAPEUT1 - Tape 
Management" on page 311 



$DISKUT1 Commands 



The commands available under $DISKUT1 are listed below. To dis- 
play this list at your terminal* enter a question mark in 
response to the prompting message COMMAND (?):, 



^m>y 



^-- 



COMMAND 
AL — 
CV — 
DE — 
EN — 
LA 
LACTS 
LD ^- 
LDCTS 
LM — 
LP ^- 
LPCTS 
LS -- 
LV ^- 
LISTP 
LISTT 
RE — 
^- 

COMMAND 



-^ 



-* 



(?) 

- A 

- C 

- D 

- E 
L 
L 
L 
L 

- L 

- L 
^ L 

- L 

- L 

- D 

- D 

- R 

- P 
(?) 



LLOCATE SPACE 

HANGE VOLUME 

ELETE MEMBER 

ND THE PROGRAM 

1ST ALL(DS/PGM) 

1ST ALL (CTS MODE) 

1ST DATA SETS 

1ST DATA SETS (CTS MODE) 

1ST 1 MEMBER 

1ST PROGRAMS 

1ST PROGRAMS (CTS MODE) 

1ST SPACE 

1ST THROUGH VOLUMES (DS/PGM) 

IRECT LISTING TO $SYSPTR 

IRECT LISTING TO TERMINAL 

ENAME A MEMBER 

REFIX (OPTIONAL) 



After the commands are displayed* you are again prompted with 
COMMAND (?);. You respond with the command of your choice (for 
example * AL ) . 

Note : In CTS mode* disk locations are shown in cylinder* track, 
and sector format instead of by record number. 
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The program prompts you for any parameters required by the 
requested function. Examples of some of the $DISKUT1 command 
execution prompts and replies are given on the following pages. 

SDISKUTl Parameters 

The following table identifies the parameters that can be used 
for the various $DISKUT1 commands. 



Funct i on 



Command 



Parameters 



Help 

Allocate Space 
Change Volume 
Delete Member 
End Uti lity 



in CTS mode 



st Ail Members 

st All Members 

st Data Sets 

st Data Sets in CTS mode 

st One Member 

st Programs 

st Programs in CTS mode 

st Space 

st Through Volumes 

rect Listing to $SYSPRTR 



Direct Listing to Terminal 
Rename Member 



AL 

CV 

DE 

EN 

LA 

LACTS 

LD 

LDCTS 

LM 

LP 

LPCTS 

LS 

LV 

LISTP 

LISTT 
RE 



None 
Name Si 
New- vo 1 
Member- 
None 
Pref i X 
Pref i X 
Pref i X 
Prefix 
Member- 
Prefix 
Prefix 
None 
P r e f i X 
Termi na 
( opt i on 
None 
Old-nam 



ze Type 

ume-label 

name 

(optional) 
(opt i onal ) 
(opt i onal ) 
(opt i onal ) 
name 

(opt i onal ) 
(opt i onal ) 

(opt i onal ) 

1-name 

al) 

e New-name 



.4" 



Note : When using the AL command, select either of the following 
organization types for the data set to be allocated: 

D - Data Organization 

P - Program: Use this only for executable object programs 
(the output of $UPDATE/$UPDATEH) 

All the functions listed (except for ?, CV, LV, and EN) 
initially act upon the IPL volume and is indicated by the mes- 
sage USING VOLUME XXXXXX when $DISKUT1 is loaded. To point to 
another volume to perform one or more of the previously listed 
functions, enter the CV command and the name of the volume. All 
functions act upon the specified volume until changed by anoth- 
er CV command or until $DISKUT1 is terminated and reloaded. If 
a prefix of up to 8 characters is specified in the List commands 
(except LM), only those data sets/programs beginning with 
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these characters are listed. The LV command scans through all 
existing volumes* listing members in each volume. When the scan 
is completed, the utility points to the last volume accessed. 
The LV command is useful in finding a data set when the volume 
is not known or when the same data set appears in multiple vol- 
umes . 



Examples 

AL - Allocate a 100 Record Data Set Named DATAFILE 



COMMAND (?): AL 
MEMBER name: DATAFILE 
HON MANY RECORDS? 100 
DEFAULT TYPE = DATA - OK? 
DATAFILE CREATED 

COMMAND (?): 






CV -• Change Volume to be Accessed by Subsequent Commands 



COMMAND (?): CV 

NEW VOLUME LABEL = EDXOOl 

COMMAND (?): 



DE - Delete a Member Named DATAFILE 



COMMAND (?): DE 
MEMBER NAME: DATAFILE 
DATAFILE DELETE? Y 
DATAFILE DELETED 

COMMAND (?): 
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LP -- List Description of the Data Sets in a Volume 



COMMAND (?): LD 

USING VOLUME EDXOOl 

NAME FREC SIZE 

TEXTHORD DATA 105 22 

$SAMDATA DATA 127 36 

$NAME3 DATA 450 10 

506 FREE RECORDS IN LIBRARY 

COMMAND C?) : 




LM - List Description of an Individual Member 



COMMAND (?): LM 
MEMBER NAME: TEST12 

USING VOLUME EDXOOl 

NAME FREC SIZE 

TEST12 DATA 305 7 

IODA,CTS=00 3,022116,022122 

COMMAND (?): 



Note : IODA,CTS= I/O Device Address, Cylinder, Track, 
and Sector. In this example, the extent of the 
member is on the device at device address 003 at cylinder 
22, track 1, from sector 16 through sector 22. 
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LP - List Description of the Program Members in Volume 



„y 



COMMAND (?): LP $DISK 

USING VOLUME EDXOOl 

NAME FREC SIZE 

$DISKUT1 PGM 256 32 
$DISKUT2 PGM 288 30 

2550 FREE RECORDS IN LIBRARY 

COMMAND (?): 



Note ■ Only members with a prefix of $DISK are listed 
in this example. 
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LS - List Free Space Available in Volume 



o 



COMMAND (?)! LS 

USING VOLUME EDXOOl 

LIBRARY 

AT REC 1 

SIZE 3600 RECORDS 

UNUSED 665 RECORDS 

DIRECTORY 

SIZE 24 RECORDS 
UNUSED 2<^50 BYTES 

NO. MEMBERS - 35 

NO. FREE SPACE ENTRIES - 

LIST FREE SPACE CHAIN? Y 



FREC 

3000 

247 



SIZE 

600 

65 



COMMAND (?): 



4" 
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LV -^ L 1 st Members wi th a Prefix of ' S' i n Al 1 Volumes 



COMMAND (?): 


tv s 






NAME 


FREC 


SIZE 


VOLUME 


SEW DATA 


1646 


100 


EDX002 


5SRC DATA 


7748 


5 


EDX002 


SMODUL DATA 


1386 


10 


A5MLIB 


SWORK DATA 


15522 


300 


EDX003 


SDATA DATA 


6989 


5 


EDX005 


USING VOLUME 


EDX005 






COMMAND (?): 









J 
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$DISKUT2 - PATCH, DUMP OR CLEAR MEMBER 



$DISKUT2 dumps or patches data or program members of a volume. 
It also can clear (set to zero) all or portions of a data set 
and reset its end-of-data pointer* list any data set created 
using $EDIT1N or $FSEDIT, and list the I/O error log data set. 



Note : For tape management 
Management" on page 311 



functions* see "$TAPEUT1 



Tape 



$DISKUT2 can also be used to modify the default load time stor- 
age allocation associated with a program. The SS (set storage) 
command allows you to change the allocation 
reassembing the source code or providing an override 
LOAD instruction. 



without 
on the 



Program dumps and patches are made by relative address 
(hexadecimal) within the program. The relative address corre- 
sponds exactly to the address specified in the LOC field of an 
assembly listing. Data can be entered in hexadecimal or EBCDIC 
as shown in the examples that follow. To convert an Event Driv- 
en Language instruction to a no operation (NOP)> patch all of 
the generated DCs to hexadecimal zero. 

Data set dumps and patches are made by specifying a record num- 
ber and a first word. The numbering for both record and word 
number begins with 1. Data can be entered in either decimal or 
hexadecimal. Each field of patch data should be separated with 
a a non-numeric character other than a carriage return. 






Dumps of programs or data sets are formatted when hexadecimal 
is selected as an option. 

$DISKUT2 can list data sets created by $EDIT1N or $FSEDIT. You 
can list all or part of a source data set on a terminal or 
pr i nter . 

A special feature of $DISKUT2 allows dumping and/or patching of 
any area on a disk volume by referencing absolute record num- 
bers. This mode is selected by entering the characters 
$$EDXVOL as a member data set name. When using this mode* 
record numbering begins with one. 

The I/O error log list commands allows the specification of any 
data set as the log data set. The option is available to print 
every log record or only those log records containing data for 
a specific device address. The output is a formatted dump. 

You are prompted* as necessary* for information required by any 
of the functions of $DISKUT2. 
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$DISKUT2 Commands 



^y 



The commands available under $DISKUT2 are listed beloM. To dis- 
play this list at your terminal* enter a question mark in 
response to the prompting command COMMAND (?). 



COMMAND (?): ? 

CD - CLEAR DATA SET 

CV - CHANGE VOLUME 

DP - DUMP DS OR PGM ON PRINTER 

DU - DUMP DS OR PGM ON CONSOLE 

(-CA- WILL CANCEL) 
PA - PATCH DS OR PGM 
SS - SET PROGRAM STORAGE PARM 
LP - LIST DS ON PRINTER 
LU - LIST DS ON CONSOLE 
PL - LIST LOG ON PRINTER 
LL - LIST LOG ON CONSOLE 
EN - END PROGRAM 

COMMAND (?): 



After the commands are displayed* you are again prompted with 
COMMAND (?):. You respond with the command of your choice (fpr 
example » CD) . 



Chapter ^ , The Utilities 



1^5 



$DISKUT2 



Examples 

CD - Clear a Data Set (to Zeros ) 



COMMAND (?)J CD 
DATA SET NAME? DATA 
CLEAR ENTIRE DATA SET? N 
FIRST RECORD; 1 
LAST RECORD: 100 

RESET THE E.O.D. POINTER? Y 
HOW MANY RECORDS TO EOD? 100 

ARE ALL PARAMETERS CORRECT? Y 
CLEAR COMPLETED 

COMMAND (?): 



DU/DP -- Dump a Data Set on Termi nal/Pr i nter 



COMMANDC?): DU 

PGM OR DS name: EDITWORK 

EDITWORK IS A DATA SET 



FIRST RECORD 
LAST RECORD 
WORDS / RECORD 
(D)EC OR HE(X) 



RECORD 1 



73 
81 
89 
97 
105 



7A2E 
0000 
0000 
0000 
0000 



78D0 
0000 
0000 
0000 
0000 



1 
X 

52 
X 



0088 
3<^D6 
14D0 
0000 
0000 



7A30 
0000 
5600 
0000 
0000 



OOOA 
0000 
0000 
0000 
5040 



lOlA 
0000 
7A02 
0000 
6F03 



D240 
0000 
0000 
0000 
023C 



<+040 
FFFF 
0000 
0000 
0254 



113 7B96 402F 7BA0 0000 182C 6808 00C4 680D 
121 7BA4 6808 00F6 680D 

DUMP COMPLETE 
ANOTHER AREA? N 
COMMANDC?) 



#. 
.6 






o 
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DU/DP - Dump a Program on Terminal/Printer 



COMMAND (?): DU 

PGM OR DS NAME: MYPROG 

MYPROG IS A PROGRAM 

ADDRESS: 22 

DUMP TO PROGRAM END? N 

HOW MANY WORDS? 22 

0022 0000 0000 1C66 FFFF 0000 0000 
0032 ^0^0 A040 40<^0 0606 40^0 ^040 

00^2 0000 0001 0001 0000 0000 

DUMP COMPLETE 
ANOTHER AREA? N 

COMMAND (?): 



$$ 






LL - List Log Data Set 



COMMAND (?): LL 
LOG DS NAME: $LOGDS 
DEVICE ADDRESSCNULL 



SOFT ERR 
DEV ADDR 



0003 



DATE: 
time: 
INTCC 
DCBl: 
DCB2: 
CSSW: 



10/26/79 
11:59:59 
07 

xxxx xxxx 
xxxx xxxx 
xxxx xxxx 



FOR ALL): 003 



DEV ID: 0304 
LVL: 0002 AKR 



RETRY 
ISB: 

XXXX xxxx 
xxxx xxxx 
xxxx 



13 
80 
XXXX 

xxxx 



IDCB 
XXXX 

xxxx 



0001 
7000 



2100 



XXXX 

xxxx 



xxxx 
xxxx 
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LU -- List a Source Data Set on Terminal 



COMMAND(?): LU 

DATA SET NAME? CALSRC 

LIST ALL OF THE DATA SET? N 

FIRST RECORD: <♦ 

LAST RECORD: 8 

ATTNLIST ATTNLIST ( STOP , POSTl , CALC , P0ST2 ) 

SPACE 1 
POSTl POST KBEVENT,! 

ENDATTN 

SPACE 1 

LIST COMPLETE 
COMMANDC?) : 
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I PA - Patch a Program in Hexadecimal 



COMMAND (?): PA 

PGM OR DS NAME: MYPROG 

MYPROG IS A PROGRAM 

address: 312 

HOW MANY WORDS? 2 

(D)EC, (E)BCDIC, OR (H)EX?: H 



NOW IS: 
0312 



D3C9 E2E3 
ENTER data: C3C1 D3D3 



NEW DATA: 
0312 



C3C1 D3D3 



Ilist 



|CALL 



OK? Y 

PATCH COMPLETE 

ANOTHER PATCH? N 

COMMAND (?): 
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I PA - Patch a Program in EBCDIC 



o 



COMMAND (?) : PA 

PGM OR DS name: MYPROG 

MYPROG IS A PROGRAM 

ADDRESS: 2D8 

HON MANY WORDS? 7 

(D)EC, (E)BCDIC, OR (H)EX?: E 

NOW IS: 
02D8 D4C5 D<^C2 C5D9 «+0C4 C5D3 C5.. 

ENTER DATA: DELETE MEMBERS 

NEW DATA: 
02D8 C4C5 D3C5 E3C5 40D4 C5D4 C2.. 

OK? Y 

PATCH COMPLETE 

ANOTHER PATCH? N 

COMMAND (?): 



1 MEMBER delete; 



1 DELETE MEMBER3 






^iu.iJ''^ 
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SS - Set Program Storage Parm : The following example shows 
reducing the dynamic storage to be allocated for the COBOL com- 
piler at program load. The SS command requires the size in 
bytes to be expressed in decimal. The value requested^ if not 
an even multiple of 256> will be rounded up. 



> $DISKUT2 

USING VOLUME EDX002 
COMMAND (?): CV ASMLIB 

COMMAND (?) : SS $COBOL 

ENTER NEW STORAGE SIZE IN BYTES: 2816 

OLD STORAGE SIZE WAS 8^^8 

OK TO CONTINUE? Y 

COMMAND (?)s EN 

$DISKUT2 ENDED AT 08:36:02 



1^ 
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$DIUTIL - DISPLAY DATA BASE UTILITY 



$DIUTIL maintains the disk resident data base used with graph- 
ics applications. This utility provides comprehensive facili- 
ties to keep the data base current by means of the following 
f unct 1 ons J 

Initialize the Disk Resident data base 



Delete a member 

Reclaim space in data base due to deleted members 

Display contents of data base 

Copy data base 

Copy individual members of data base 

Allocate and build a data member 



This utility is normally used only when no other programs of 
the Display Processor are in use. The online data base can be 
changed or you may select another data base to be referenced. 
This allows you to create displays in a data base other than the 
online data base and then copy the members into the online data 
base after testing. 



\J 



Invoking $DIUTIL 



To start execution of $DIUTIL: 

1. Load the program $DIUTIL specifying the appropriate data 
set. $DIFILE» the online data set» or any other data set 
can be used. However* you should make sure that another 
user or program is not changing or using the same data set. 

2. The system responds with the Program Loaded message fol- 
lowed by ! 



DISPLAY DATA BASE UTILITY 
COMMAND (?): 



^V-^' 
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$DIUTIL Commands 



The commands available under $DIUTIL are listed below. To dis- 
play this list at your terminal? enter a question mark in reply 
to the prompting message COMMAND (?):. 



COMMAND (?): ? 

AL - ALLOCATE DATA MEMBER 

BU - BUILD DATA MEMBER 

CP - COMPRESS DATA BASE 

CM - COPY MEMBER 

DE - DELETE A MEMBER 

EN - EXIT PROGRAM 

IN - INITIALIZE DATA BASE 

LA - DISPLAY MEMBER DIRECTORY 

LH - DISPLAY MEMBER HEADER 

MD - MOVE DATA BASE 

RE - RENAME MEMBER 

ST - DISPLAY DATA SET STATUS 

COMMAND (?): 



After the commands are displayed, you are again prompted with 
COMMAND (?): to which you respond with the command symbol for 
the function of your choice (for example, AL) . 

AL - Allocate Data Member 

Reserves space in a data base for one of several types of data 
members. Information such as size in sectors and member code 
is requested. Member codes are specified as follows: 

^ - Print Report Data Member ? Information such as number of 
lines and line length are requested. Each line is then 
entered, limited to 132 characters. 

5 - Plot Curve Data Member : Information such as X and Y ranges, 
X and Y base values and number of points to plot are requested. 
Automatic entry of the X points can be selected to reduce the 
data entry requirements, A sawtooth pattern option is provided 
to shade under the curve for more vivid presentation of plotted 
data. Using less than 200 points on the X axis gives an inade- 
quate shading effect. 
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6 - Realtime Data Member : The number of records is requested. 
You can enter hexadecimal data for testing. 



..J' 



7 thru 9 "User Data Member : These codes are used by the build 
function to guide you through the correct data entry procedure. 



COMMAND 


(?): 


AL 




MEMBER 


NAME: 


TDATA 




ENTER # 


OF RECORDS TO ALLOCATE? 


10 


ENTER MEMBER 


CODE #: <> 




MEMBER 


TDATA 


ALLOCATED 




COMMAND 


(?): 













152 SC3<»-0313 



o 



SDIUTIL 



BU - Build Data Member 

Inserts fixed data into a data member. This allows you to enter 
data records to describe a fixed display or enter records* 
which normally will be dynamic* with a fixed value* to allow 
testing of the display. 

The member may have been allocated using AL» if not* you are 
prompted for the requisite allocation information before pro- 
ceeding with the "build" process. You are guided one step at a 
time through the initialization of the data member* 






COMMAND C?): BU 

ENTER MEMBER NAME: RDATA 

INITIALIZE REPORT DATA MEMBER 

ENTER # OF LINES IN REPORT: 2 

LINE LENGTH=32 

ENTER LINE ITEMS 

LINE ONE OF REPORT 

LINE TWO OF REPORT 

MEMBER LOADED 

COMMAND (?): 



In this case* the member had already been allocated. 
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CP -* Compress Data Base 



Compress reclaims unused space in the data base. Deleted mem- 
bers are not actually removed; the space is merely flagged 
unusable. The insert function of $DICOMP also flags space as 
unusable. CM is used to reclaim this space for future use. As 
each member is moved* a message is displayed. At the com- 
pletion of the compress function, the message COMPRESS COM- 
PLETED is displayed. 

Caution should be exercised in using this function as it actu- 
ally rearranges the members in the data base. It is advisable, 
in order to prevent unpredictable results, to restrict the use 
of the Interpreter ($DIINTR) during this process. 



Cauti on? I f 
destroyed . 



an unrecoverable I/O error occurs, the data set is 



COMMAND (?): CP 

WARNING — COMPRESS IN PLACE. IF AN ERROR 
SHOULD OCCUR DATASET WILL BE DESTROYED 
DO YOU WISH TO PROCEED? Y 



DATA 

RDATA 

REPORT 

SQUARE 

CIRCLE 

RPT 

ARC 

PLOT 



COPIED 
COPIED 
COPIED 
COPIED 
COPIED 
COPIED 
COPIED 
COPIED 



COMPRESS COMPLETED 



COMMAND (?): 



^ktjii*'^ 
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CM - Copy Member 



Copies a member from the source data base to the target data 
base. The options available in MD are also included in CM. 



COMMAND (?): CM 

SOURCE DATASET NAME: $DIFILE 

LOCATED ON VOLUME: EDX002 

CHANGE SOURCE DATASET? N 

TARGET (NAME, VOLUME): $DIFILE, EDX003 

SAVE EXISTING MEMBERS IN TARGET DATA BASE? 

ENTER MEMBER NAME TO BE COPIED 

PLOT 

PLOT COPIED 

COPY COMPLETED 

COMMAND (?): 
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DE - Delete a Member 



Removes display or data members from the data base. You are 
prompted for the name of the member to be deleted and asked to 
verify the accuracy of your entry prior to actual deletion^ 



COMMAND (?): DE 



MEMBER NAME: 
DELETE MEMBER 
PLTT DELETED 

COMMAND (?): 



PLTT 
PLTT? Y 



EN ~ Exit Program 

Causes the Display Processor utility to be terminated. 



\..,j^ 



o 
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IN ~ Initialize Data Base 

Formats the entire data base to zeros and formats the directory 
to reflect the starting and ending record numbers. After 
entry* you are prompted to proceed. 

Cauti on: This function destroys any data in the data base. 

Make sure the data set name entered is correct. The command is 
terminated when the message DATA SET FORMATTED is displayed. 
$DIFILE Mas allocated by $DISKUT1. Each directory record allo- 
cated by IN contains sixteen directory entries* except the 
first* which contains fifteen. 



COMMAND (?): IN 

*-?<-WARNING THIS FUNCTION WILL DESTROY ANY DATA 

CURRENTLY IN DATA SET-^-^ 

DO YOU WISH TO PROCEED? Y 
ENTER DIRECTORY SIZE IN RECORDS; 2 
DATA SET FORMATTED 
DATASET name: $DIFILE 
LOCATED ON VOLUME: EDX002 
- DATA SET -~ DIRECTORY- 
NEXT TOTAL NEXT TOTAL 
3 100 1 31 

END OF STATUS 

COMMAND (?): 
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LA ~ Display Directory 

Displays all active members. Each line of display shows the 
member name followed by four values: 

1. Starting sector relative to the start of the data base. 

2. Length of member in records. 

3. Member usage code. 

4. User defined member code. 






COMMAND (?): 


LA 








PLOT 


11 


4 


2 





DATA 


15 


10 


5 





RDATA 


25 


10 


4 





REPORT 


35 




1 





SQUARE 


36 




2 





CIRCLE 


38 




2 





RPT 


39 




1 





ARC 


40 




2 





COMMAND (?): 











^ J 



c 



158 SC34-0313 



$DIUTIL 



LH - Display Member Header 



Displays the header of a data member (types 4-9). The header 
describes the characteristics and use of the member. For a 
description of header contents* see Data Set Format in IBM 
Series/1 Event Driven Executive System Guide * SC34-0312 



Example : 

COMMAND (?): LH 
MEMBER NAME: RDATA 
MEMBER RDATA HEADER 


END OF HEADER 

COMMAND (?): 



32 



80 
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MD - Move Data Base 






Moves the data base on the same or another volume when the data 
base becomes too small to add a member. You can temporarily 
move the online data base to another location* delete the old 
version* reallocate and initialize the new expanded version* 
and move back the previous contents. During this procedure* 
care should be observed in the use of the Interpreter. 

Cauti on' If the data base is being moved and the Interpreter 
uses a member, unpredictable results will occur. 

During the. execution of MD* you are prompted for a new source 
data base if desired and a target data base. You have the 
option of saving the members in the target data base. MD is 
helpful if you wish to use $DICOMP to develop display members 
in a different data base than the online version and then* at a 
later time, combine the new members with those in the online 
data base . 



COMMAND (?): MD 
SOURCE DATASET NAME: SDIFILE 
LOCATED ON VOLUME: EDX002 
CHANGE SOURCE DATASET? N 



TARGET CNAME*VOLUME) : 

SAVE EXISTING MEMBERS 

PLOT 

DATA 

RDATA 

REPORT 

SQUARE 

CIRCLE 

RPT 

ARC 



$DIFILE,EDX003 

IN TARGET DATA 



BASE? Y 



COPIED 
COPIED 
COPIED 
COPIED 
COPIED 
COPIED 
COPIED 
COPIED 
COPY COMPLETED 

COMMAND (?): 



V..... 
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Changes the Display Profile ID name. You are prompted for each 
step and no action is taken unless your response is first 
obtained. RE is useful v^hen an online member needs to be modi- 
fied. The member that t ^ eeds changing can be copied to another 
data base» modified and tested^ then renamed and copied back to 
the online data base. By using the rename and delete func- 
tionst you can exchange the new for the old without interfering 
with any online functions. 



COMMAND (?): RE 
MEMBER NAME: PLOT 
ENTER NEW NAME: PLTT 
RENAME COMPLETED 

COMMAND (?): 
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ST - Display Data Set Status 



.._y 



Displays the current data base status. The first line shoMS 
the data base location and name. The data that follows is the 
current status of the data base. There are ^ values presented. 
The first is the next available record. The second is the total 
number of records in the data base. You can then see how much 
space is available for new members. If space is running short, 
you can compress the data base or allocate a larger area. The 
next value displayed is the next available directory entry. 
The last value displayed is the total number of directory 
entries available. Refer to these two values to determine if 
more or less space is needed for directory entries. Following 
the completion of the status display the message END OF STATUS 
i s d i splayed . 



COMMAND (?): ST 
DATASET NAME: SDIFILE 
LOCATED ON VOLUME: EDX002 
- DATA SET — DIRECTORY- 
NEXT TOTAL NEXT TOTAL 
41 100 10 159 

END OF STATUS 

COMMAND (?): 
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$DUMP - FORMAT AND DISPLAY SAVED ENVIRONMENT 



$DUMP displays on a terminal or printer the contents of the 
data set generated by the $TRAP utility. After the successful 
execution of $TRAP and the subsequent occurrence of a trap con- 
dition» the data set assigned to $TRAP will contain a storage 
image. Use $DUMP to retrieve* format* and print the data on a 
terminal or printer. 



Invoking $DUMP 



$DUMP can be invoked by the session manager using the Diagnos 
tic Utilities option menu or by the $L command. 
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Example 

Dump Part of Supervisor Partition to Printer 






< $L $DUMP 

DUMPDSCNAME, VOLUME): DUMP,EDX003 
$DUMP 22P, 12:20:17, LP=8F00 

ENTER DEVICE NAME FOR OUTPUT 
SSYSPRTR 

PARTIAL DISPLAY? (Y/N): Y 

ENTER PARTITION # OR S FOR SUPERVISOR S 
ENTER START END ADDR IN HEX 100 

EVENT DRIVEN EXECUTIVE FORMATTED STORAGE DUMP 

AT TIME OF TRAP PSW WAS 8002 ON HARDWARE LEVEL 2 

LEVEL LEVEL 1 LEVEL 2 LEVEL 3 



Notes 
(1) 



Hi 

(<f) 
(5) 



lAR 


0892 


0892 


0892 


0892 


AKR 


0000 


0000 


0000 


0000 


L5R 


OODO 


0090 


0090 


0090 


RO 


0000 


0000 


0000 


0000 


Rl 


0000 


0000 


0000 


0000 


R2 


0000 


0000 


0000 


0000 


R3 


0000 


0000 


0000 


0000 


R^ 


0000 


0000 


0000 


0000 


R5 


0000 


0001 


0002 


0005 


R6 


8000 


8000 


8000 


8000 


R7 


0000 


0000 


0000 


0000 



"^^z-. 



t 
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Dump Part of Supervisor Partition to Printer (cont,) 
Notes ' 



The data set specified here must 
defined when $TRAP was executed. 



be the same as that 



You can specify a terminal to receive the output from 
$DUMP. If the operator presses the 'ENTER' key or enters 
'$DUMP'', the dump program assumes that the output is to be 
directed to the terminal that loaded $DUMP. Using the 
attention key followed by 'CA* cancels the $DUMP program. 

If a display of all storage is desired then respond to this 
question with a 'N*. If 'N* is used» the output display 
begins immediately and continue until all of storage is 
dumped or an attention 'CA' is entered. If ' Y ' is usedf 
$DUMP allows sections of storage to be displayed. 



Enter an 'S* for the supervisor partition o 
through 8 for the partition number to dump. 



r the number 1 



Enter the starting and ending addresses 
included in this section of the output. 



that should be 
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Dump Part of Supervisor Partition to Printer (cont.) 



SEGMENTATION 


REGISTERS 






BLOCK 


ADSO 


ADSl 


ADS2 


ADS3 ADS4 ADS5 


ADS6 ADS7 


0000 


0004 


0104 


0204 


0304 




0800 


OOOC 


OlOC 


020C 


030C 




100 


0014 


0114 


0214 


0314 




1800 


OOIC 


one 


021C 


031C 




2000 


0024 


0124 


0224 


0324 




2800 


002C 


012C 


022C 


032C 




3000 


0034 


0134 


0234 


0334 




3800 


003C 


013C 


023C 


033C 




^000 


0044 


0144 


0244 


0344 




^800 


004C 


014C 


024C 


034C 




5000 


0054 


0154 


0254 


0354 




5800 


005C 


015C 


025C 


035C 




6000 


0064 


0164 


0264 


0364 




6800 


006C 


016C 


026C 


036C 




7000 


0074 


0174 


0274 


0374 




7800 


007C 


017C 


027C 


037C 




8000 


0084 


0184 


0284 


0384 




8800 


008C 


018C 


028C 


038C 




9000 


0094 


0194 


0294 


0394 




9800 


009C 


019C 


029C 


039C 




AOOO 


00A4 


01A4 


02A4 


03A4 




A800 


OOAC 


OlAC 


02AC 


03AC 




BOOO 


00B4 


01B4 


02B4 


03B4 




B800 


OOBC 


OIBC 


02BC 


03BC 




COOO 


00C4 


01C4 


02C4 


03C4 




C800 


OOCC 


OICC 


02CC 


03CC 




DOOO 


00D4 


01D4 


02D4 


03D4 




D800 


OODC 


OlDC 


02DC 


03DC 




EOOO 


00E4 


01E4 


02E4 


03E4 




E800 


OOEC 


OlEC 


02EC 


03EC 




FOOO 


00F4 


01F4 


02F4 


03F4 




F800 


OOFC 


OlFC 


02FC 


03FC 





^,.r>^ 
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Dump Part of Supervisor Partition to Printer (cont.) 



STORAGE MAP: 


$SYSCOM AT ADDRESS 3420 


PART* NAME 


ADDR 


PAGES 


TCB 


PI 


*^PART^^ 


9F0O 


97 




PI 


$TRAP 


9F00 


21 


B2B4 


PI 


Jf^FREE^Jf 


B400 


76 




P2 


^^PART^^ 


0000 


256 




P2 


x^FREE^^ 


0000 


256 




P3 


*JePART?^?t 


0000 


256 




P3 


x^FREE^^t 


0000 


256 




P^ 


^^PART^^ 


0000 


256 




P^ 


$SMMAIN 


0000 


4 


02F8 


P4 


$SMLOG 


0400 


34 


1978 


P^ 


^^FREEx^ 


2600 


218 
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Dump Part of Supervisor Partition toPrinter Ccont.) 






TERMINAL LIST: 

NAME CCB ID ADDR 



$SYSLOG 

$TERM1 

$TERM2 

$SYSLOGA 

$5YSPRTR 



1876 
1A82 
0C32 
IDCC 
1F86 



0406 0004 

040E 0005 

040E 0006 

0010 0000 

0306 0001 



DSKCETTE) LIST: 
NAME DDB TYPE 



EDXOOl 
EDX002 
ASMLIB 
SUPLIB 
MACLIB 
EDX002 



165E 
16F0 
1782 
17A2 
17C2 
17E2 



PRI 
PRI 
SEC 
SEC 
SEC 
SEC 



ID 

0106 
OOAA 



ORG 





92 

108 

124 

202 



SIZE 



LIB 



ADDR 



75 


27 


0002 


92 


2461 


0003 IP 


16 






16 






78 






102 







SUPV BEGINNING AT ADDRESS 0000 FOR 139 PAGES 



0000 



6802 882A 0000 0000 8968 8826 8969 8826 



0010 0000 0000 8968 8826 0A76 0A12 8968 8826 

SAME AS ABOVE 
0100 12DC 8BC2 0004 0006 1010 6A08 03F8 5B22 |...B 



ANOTHER AREA? (Y/N): N 



Note 



Note : $DUMP allows you to request several partial dumps. If a 
'Y^ response is entered* then $DUMP prompts you for the start- 
ing and ending addresses that are to be dumped. See note 4. 
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$EDIT1 AND SEDITIN - LINE EDITORS 



$EDIT1 and $EDIT1N provide a text editing facility (primarily 
used for source program entry and editing) that can be invoked 
simultaneously with the execution of other programs. The Host 
Communication Facility related version ($EDIT1) provides a few 
commands for data communication using the Host Communications 
Facility lUP on the System/370 so that almost the entire proc- 
ess of program preparation can be controlled from a Series/1 
terminal. The native program preparation version ($EDIT1N) 
produces members that can be processed by the Series/1 assem- 
bler. 

Both versions work with 80-character lines that are line num- 
bered in positions 73-80 and are invoked by the $L command. 



Data Set Requirements 

One work data set is required by the editing facility and must 
be allocated on disk or diskette using ODISKUTl, You are 
prompted for its name when either version is loaded. This data 
set contains both your data and some index information during 
the editing session^ and the size (number of records) of the 
data set determines the maximum number of data records that it 
can contain. It is divided into three parts: 

1. One header record 

2. A series of index records (32 entries per record) 

3. A series of data records (3 entries per record) 

The required data set size can be calculated as follows: number 
of text lines (n) divided by 30> times 11» plus 1 ((n/30 x 11) + 
1) , 
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Sequence of Operations 



K.) 



When the edit program is loaded^ it prompts you for the name of 
the work data set to be used. If an existing data set is to be 
edited, the READ command should be used to copy the data set to 
the work data set. For a new data set, edit mode should be 
invoked. The contents of the work data set can be printed using 
the LIST command. 



The EDIT command is used to enter edit mode. Edit subcommands 
are then recognized until terminated by the END command. 

Note ? You should use the VERIFY ON subcommand until you become 
familiar with the editing process. 

The TABSET subcommand is used, if desired, to specify the tab 
character and tab column. This eliminates the entry of blanks 
when a substantial amount of the text to be entered is in tabu- 
lar format or begins in a particular column. 

Data can be entered a line at a time under the INPUT subcommand 
(recommended for new data sets and bulk sequential updates 
because of the automatic prompting feature) or by using the 
line editing function (for single line corrections). Portions 
of the edited data can be listed at the terminal using the LIST 
command . 



y 



The position of the current line pointer is controlled by the 
FIND, TOP, BOTTOM, UP, and DOWN subcommands. 

Edit mode is terminated with the END command. When the text has 
been edited, copy the work data set to a permanent data set 
using either the WRITE or SAVE subcommand. The work data set is 
in a blocked format that is incompatible with most Event Driven 
Executive functions. Automatic translation from text editor 
format to source statement format is performed. 



The following figure shows the primary commands 
mands available under $EDIT1/$EDIT1N . 



and subcom- 



,'f 
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>$L$EDIT1/N 






1 










' 








Editor ready 




COMMANDS 












1 




' ' 




\ 






LIST (printer) 
READ 
WRITE 
SUBMIT 




END$ED!T1/N 




EDIT 










\ 






Edit mode 










SUBCOMMANDS 












\ 




\ 




' ' 




1 






INPUT 




END 




LIST (terminal) 

VERIFY 

RENUM 

SAVE 

TABSET 




LINE EDIT 


























CHANGE 
COPY 
DELETE 
MOVE 




FIND 

TOP 

BO 1 1 OM 

UP 

DOWN 





















I Figure 20. $EDIT1/$EDIT1N Commands and Subcommands 



^%. 
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Special Control Keys 



c 



End of Line Character (see note beloM). The Carriage Return 
Key (CR)/ENTER is used to end an input line. 

Line Delete Character (see note beloM). The Delete Key 
(DEL) of certain teletypewriter terminals is used to 
delete an input line. 



Note i CR and DEL keys can be defined 
statement. See the System Guide . 



in the TERMINAL 



Character Delete Character. The backspace (BS) key on ter- 
minals is used for the character delete function. On tele- 
typewriter terminals* use the CTRL and H keys 
s i mul taneous ly . 

Tabulation Character. You can set the TAB character to the 
character of your choice. '%' is the default TAB character. 
Columns 10* 20> ^0> and 72 are the default TAB columns. 



ATTN Key (4978/<^979) or ESC or ALT MODE Key (teletypewriter 
terminals). The subcommands CHANGE* FIND» and LIST» 
described below* can be cancelled by pressing the ATTN/ESC 
key and entering* as a special system utility function* the 
two character code CA. This feature is useful* for example* 
to terminate a long listing. 



^<i„->' 
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The editor commands are described in the following pages. 
Unless specifically indicated^ the commands apply to both the 
host and native versions of this utility. The editor commands 
are * 



COMMAND 



DESCRIPTION 



EDIT 

END 

LIST 

READ 

SUBMIT 

NRITE 



Enters edit mode; allows edit subcommands 
Terminates $EDIT1/$EDIT1N 

Lists the work data set on the system printer 
Reads a source data set into the work data set 
Submits a job to the host batch job stream 
Writes the work data set into a source data set 
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EDIT - Enter Edit Mode 

EDIT is used to begin editing source data 

Syntax 



EDIT 



OLD/NEW 



Requ i red : None 

Defaults: NEW when using a newly allocated work data set 

OLD when using an old work data set. 
Alias: E , E D 



Operands 
OLD 

NEN 
Notes : 



Descr i pt i on 

Indicates that data exists in the data set you want 
to mod i f y . 

Indicates that you are creating new data. 



^^ y 



1. The EDIT command must be entered before the editor subcom- 
mands can be used. 

2. When in edit mode* the subcommand END or SAVE must be 
entered before the editor commands listed on the preceding 
page can be used . 
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END - End $EDIT1/$EDIT1N 

END terminates execution of $EDIT1 or $EDIT1N. 

The contents of the edit work data set are unchanged. You can 
reinvoke $EDIT1/N at a later time and continue. 

Syntax 



END 

Required: None 

Defaults: None 

Alias: EN 



No operands are required. 
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LIST - List Work Data Set 



LIST prints all or part of the work data set on the system 
printer ($SYSPRTR). A single line number can be specified or a 
pair of line numbers can be entered to specify a line range. If 
no line numbers are specified, the entire data set is listed. 
Listing can be terminated by entering ATTN and CA. Note a simi- 
larity to the EDIT subcommand. As a command following READY, 
the data set is printed on $SYSPRTR. As a subcommand following 
EDIT, the data set is displayed on your terminal. 

Syntax 



LIST 



1 i ne-spec 



Requ i red : None 
Defaults! None 
Alias: L,LI 



Operands 
1 i ne-spec 







Examples 




c 
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READ - Retrieve Host Data Set ($EDIT1) 



READ retrieves a data set from the host system and stores it in 
your Series/1 work data set. 



The Host Communications Facility on 
requ i r ed . 



the System/370 is 



Syntax 



READ 



dsname 



Required: None 

Defaults: If dsname is omitted* the system prompts you 

Alias! None 






Operands Descr i pt i on 

dsname The fully qualified 
retrieved. It must 
80 bytes in length* 
73-80. 



name of the host data set to be 
contain fixed length records* 
with line numbers in columns 



You can enter the command and name together on the 
same line or enter the command READ and the system 
prompts for the data set name. 
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READ *- Retrieve Series/l Data Set (SEDITIN) 

READ retrieves a named data set from a volume on the Series/1 
disk or diskette and stores it in a Series/1 work data set 

Syntax 



READ 

Requ i red : 

Default: 

Alias: 



dsname volname 

None - System prompts for operands 

R, RE 



Operands Descr i pt i on 

dsname Name of data set to be retrieved. 

volname Name of the volume containing the data set to be 
retr i eved . 

Note : These operands are entered as responses to system 
prompts . 



\,:J 



178 SC34-0313 



o 



$EDXT1 and $EDIT1N 



SUBMIT - Submit Job to Host ($EDIT1) 

SUBMIT injects a job (JCL and optional data) into the host 
batch job stream . 

The Host Communications Facility on the System/370 is 
requ i red . 

Note ? This option is only to be used in systems with a HASP or 
JES/Host Communication Facility interface. 

Syntax 



SUBMIT 
SUBMIT 



dsname 
DIRECT 



Operands Descr i pt i on 

dsname The fully qualified name of the host data set» the 
contents of which are to be entered into the job 
stream. This data set must contain fixed length, 80 
byte records. 

DIRECT If specified* the contents of your edit work data 
set are transferred directly to the host job 
stream . 



Chapter 4. The Utilities 



179 



$EDIT1 and $EDIT1N 



WRITE - Write Work Data Set to Host ($EDIT1) 

WRITE transfers your Series/1 work data set to a host data set. 
It is assumed that your data set has been created or edited with 
the $EDIT1 utility program. 



The Host Communications Facility 
requ i red . 



on 



the System/370 is 



If a host data set has been previously specified* you are asked 
if you wish to reuse it. If not* or if one was not previously 
specified* you are prompted for a new host data set name. 

Syntax 



WRITE dsname 



Operands Descr i pt i on 

dsname The fully qualified name of the target host data 
set. This data set should contain fixed length 
80-byte records. 



^ 



You can enter the command and name together on the 
same line or enter only the command WRITE and the 
system prompts you for the data set name. 



c 
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MRITE - Urite Mork Data Set to Series/1 Data Set ($EDIT1N) 

WRITE copies the Series/1 work data set to a named data set in a 
Series/1 disk or diskette volume. 



Syntax 



WRITE 

Required? None - System prompts you for operands 

Default? Copy to the originating data set* if any 

Alias: W, WR 



No operands are required. 

The following prompt is issued by EDITIN: 




where 'READVOL' is the originating volume and *READVS' is the 
originating data set. This prompt is issued only if the work 
data set was initialized via the READ command. If the response 
is 'NO' or the data set is new» the following prompt is issued? 
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Edit Mode Subcommands 



The subcommands used to edit your work data set while in EDIT 
mode are described as follows: 



Subcommand 



BOTTOM 

CHANGE 

COPY 

DELETE 

DOMN 

END 

FIND 

INPUT 

Line Editing 

LIST 

MOVE 

RENUM 

SAVE 

TABSET 

TOP 

UP 

VERIFY 



Operands 



line-spec /text l/text2/ALL 
1 i ne-spec 
1 i ne-spec 
count 

/character-string/ 

line-number increment 

line-number character-string 

1 i ne-spec 

1 i ne-spec 

new-line-number increment 

ON(integer list), OFF, CH (character ) 

count 
ON/OFF 



\i^ 



J 
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BOTTOM - Set Line Pointer to Bottom 



BOTTOM repositions the current line pointer (?f) to the last 
line of the data set being edited. 

Syntax 



BOTTOM 

Requ i red : None 

Defaults: None 

Alias: B » B 



No operands are required. 
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CHANGE - Change Character String 

CHANGE modifies a character string in a line or range of lines 

Syntax 



o 



CHANGE 



line-spec /text l/text2/ALL 



Required: /textl/text2 

Defaults? line-spec defaults to ^. 

Alias: C»CH 



Operands Descr i pt i on 

line -spec *^* or blank for the current line. 

**f count' or 'linenuml linen um2' for a range of 
1 i nes . 

'line-number' for a particular line. 



/textl/text2/ALL 



'/' can be any non-numeric character except BLANK* 
TAB* and ASTERISK. It is not a part of, and cannot 
appear within the character strings 'textl' and 
'text2'. The line or range of lines is searched for 
'textl', which* if found* is replaced by 'text2'. 
Note that the same character must be used for both 
delimiters in any one change command. 

The keyword 'ALL' is optional and causes every 
occurrence of 'textl' to be replaced in the 
1 i n e ( s ) . 

Two adjoining delimiters denote a null operand. If 
textl is a null operand* then text2 is inserted at 
the start of the line. The line is shifted right. If 
texts is a null operand and textl is specified* 
text2 is removed from the line and the rest of the 
line sh i f ted left . 



V 
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Example 



C 20 /ABC/ADC/ 

C 100 250 =/x=//=ALL 

C ^ //XYZ 

C /PROG/PGM/ 
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COPY - Copy Text 

COPY duplicates text* from one location in 
another location within that data set. The 
text both remain in the data set. 



a data sety at 
*from* and 'to* 



Syntax 



COPY 

Required 
Defaults 

Alias: 



linenuml linenum2 linenum3 



1 i nenuml 
1 i nenuml 
a single 
CO 



1 i nenum3 

linenumS defaults to 

1 i ne copy of ' 1 ' to 



Operands Descr i pt i on 

linenuml The first line of text to be copied. 

Iinenum2 The last line of text to be copied. 

linenumS The line of text after which the copied text is to 
be placed . 

All specified line numbers must exist. 'linenumS* 
must be equal to or greater than 'linenuml'. 
'Iinenum3' must be less than 'linenuml' or equal to 
or greater than *linenum2' when three line numbers 
are specified. The data set is renumbered with 
standard specifications. The original 'linenumZ' 
is listed with its new line number on exit. 
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CO 100 300 60 

CO 120 250 820 

CO 150 150 310 

COPY 150 310 



Note : The last two examples are equivalent 
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DELETE - Delete Text 



DELETE removes records from the data set. The current line 
pointer (^) is repositioned prior to the deleted lines. 

Syntax 



DELETE 



1 i ne-spec 



Required: None 
Defaults: ^ 
Alias: DE 



Operands Descr i pt i on 
line-spec ^ for current line. 



'^ count* or Minenurnl linenum2* for a range of 
1 i nes . 

'line-number' for a particular line. 



V_.y 



Example 



DELETE ^ 
DE ^ 4 
DE 100 150 
DE 125 
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DOMN - Move Line Pointer Down 



DOWN moves the current line pointer (^) toward the end of the 
data set . 

Syntax 



DOWN 



count 



Requ i red : None 

Defaults: 'COUNT' defaults to 1. 

Al i as : DO 



Operands Descr i pt i on 

count Specifies the number of lines the current line 
pointer is to be moved. 



"^ 



Example 



DOWN 5 
DO 10 
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END - Exit Edit Mode 



END requests that the EDIT mode be terminated. The editor com- 
mands can now be used relative to your finished source data. To 
save or list your data set or to write or submit your data set 
to the hostf see "Editor Commands" on page 173. The contents of 
the work data set remain unchanged. You can re-enter the edit 
mode using the EDIT command and continue editing the work data 
set . 

Syntax 



END 

Requ i red J 
Defaults: 
Alias: 



None 
None 
EN 



No operands are required. 



! 
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FIND - Find Character String 

FIND searches for a specified character string beginning with 
the current line» if operands are specified (see S yntax . ) The 
current line pointer ( J« ) is moved to the first line found to 
contain the string. The search is made at every position with- 
i n each line. 

Note i VERIFY should be set to ON when using the FIND command. 

Syntax 



FIND =char-str i ng= 

Required: None 

Defaults: If no operands are specified* those specified 
on the last previous issue of the FIND 
subcommand are assumed. The search begins at 
the line following the current line. 

Ali as: F ,FI 



*''% 



Operands Descr i pt i on 
= char~str i ng = 



Example 



The string delimiter can be chosen to be any non- 
numeric character* except BLANK* TAB* or ASTERISK 
and which does not appear within the specified 
character string. The second occurrence can be 
replaced by a carriage return. Note that both 
delimiters must be the same character. 



FIND /START/ 

F 

FI =DATA X'00F1'= 
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INPUT - Input Text 



J 



INPUT allows lines to be added or replaced. INPUT can be used 
any time in edit mode by pressing the ENTER key. Lines are then 
added to the end of the data set. 

To terminate INPUT mode* press the ENTER key immediately after 
you receive the prompt for the next line number to be entered. 

Syntax 



INPUT line-number increment 
or 
¥i i ncrement 

Requ i red '- None 

Defaults! Increment defaults to previous or 10 

Alias: I, IN 



Op erands Descr i pt i on 
1 i ne~number 



,.r 



The first line inserted will have this number* or 
this number plus the increment if the specified 
line number already exists. 

increment The increment for numbering inserted lines. The 
default is the previously specified increment or 10 
if not specified. 

* Lines are to be inserted at the current line 

position plus the default increment. If no oper- 
ands are specified* lines are to be inserted at the 
end of the data set plus the default increment. 
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INPUT ^ 1 
IN 100 5 
I 20 
I 
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LIST - List Work Data Set 

LIST displays, at the terminal, lines of the data set being 
ed i ted . 

Syntax 






LIST 



1 i ne~5pec 



Required: None 

Defaults? line-spec defaults to entire data set 

Alias: L , L I 



Operands 
1 i ne-spec 

Example 



Descr i pt i on 

(X) or line-number to indicate a single line to be 
listed. '^ count* or 'linenuml linenum2' to dis- 
play a range of lines. 



x_y 



LIST 10 100 
L ^ 5 
L ^ 
LI 
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MOVE - Move Text 



MOVE moves text from one location in a data set to another 
location within that data set. The 'from' text is deleted and 
only the 'to' text remains in the data set. 

Syntax 



MOVE 



Alias: 



linenuml linenum2 linenumS 



Required: linenuml linenum3 

Defaults: linenuml linenumS defaults to move one line 



MO 



Operands Descr i pt i on 

linenuml The first line of text to be moved. 



1 i nenumZ 



The last line of text to be moved. 



linenumS The line of text after which the moved text is to be 
p laced . 

All specified line numbers must exist. 'linenumZ' must be 
equal to or greater than 'linenuml'. 'Iinenum3' must be less 
than 'linenuml' or greater than 'linenum2' when three lir>e mem- 
bers are specified. The data set is renumbered with standard 
specifications. The original 'linenum2' is listed with its new 
line number on exit. 

Example 



MO 100 300 60 
MO 120 250 820 
MO 87 87 310 
MOVE 87 310 

Note : The last two examples are equivalent 
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RENUM - Renumber Work Data Set 

RENUM renumbers each line of a line numbered data set or 
assigns line numbers to each line of an unnumbered data set. 



RENUM 



new~l i ne~number increment 



Requ i red J None 

Defaults? Both new-line-number and increment 

default to 10 . 
Alias: R , RE 



Note : * new-1 i ne-number ' is required if 'increment' is 
spec i f i ed . 



Operands Descr i pt i on 

new-line-number 

The sequence number to be assigned to the first line 
processed . 

increment The increment to be used in renumbering. 

Example 



'A, ,y 



RENUM 10 10 
RE 100 5 
RENUM 
R 
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SAVE - Save Work Data Set 



SAVE writes the current contents of tlie work data set to a host 
data set with the host related version ($EDIT1) or to a 
Series/1 data set with the native related version C$EDIT1N). 

If a data set has been previously specified (e,g.j in a READ 
command), you are asked if you wish to write onto that data set; 
otherwise* you are prompted for a new data set name. 

Syntax 



SAVE 



dsname 



Required: None 
Defaults: None 
Al i as : S, SA 



c 



Operands 
dsname 



Descr i pt i on 

When using $EDIT1» you are prompted for the target 
host data set name. It must be a fully qualified 
data set name . 

When using $EDIT1N, the target data set must have 
been previously allocated in a volume on a Series/l 
disk or diskette. The data set should contain fixed 
length records, 80 bytes in length. You are 
prompted for the target volume name. 



Example 
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TABSET - Set Tabs 

TABSET reestablishes tab values or nullifies existing tab val- 
ues. The tabulation character and tab stop values are main- 
tained as part of your work data set. (They can be changed 
later ) . 

The tab character can be entered anywhere in the data line 
under the INPUT subcommand or line editing function. It causes 
a skip to the next tab position when the data line is entered 
into the work data set. The resulting line is not visible^ but 
can be displayed if desired. 

Syntax 



TABSET 
TABSET 
TABSET 

Requ i red J 
Defaults : 
Alias: 



0N( i nteger-1 i st ) 

OFF 

CH( tab -character) 



ON, OFF, 

None 

TA 



or CH 



H.-,y 



Operands Descr i pt i on 
i nteger-1 i st 



The relative column positions in each line to which 
tab values are to be set. Initial system defaults 
are 10, 20 , ^0, and 72. 



tab-character 



A new tab character. The standard is a percent 
si gn . 



OFF 



Terminates the tab function. 
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Examples 



TABSET ONdO 20 ^0 
TA ONdO 16 31) 
TA CH(#) 
TA OFF 



72) 



TABSET ONdO 20) 

36 %TAB POSITION 1 
INPUT 37 1 

INPUT 

00037 %%TAB POSITION 
00038 



EDIT 
LIST 36 
00036 
00037 



37 



TAB POSITION 1 

TAB POSITION 
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TOP - Set Line Pointer to Top 



TOP positions the current line pointer (^) before the first 
line of the data set. 



TOP 

Required: None 

Defaults? None 

Al i as : TO 



No operands are required. 

N ote : If VERIFY is ON, no line is printed because the current 
line number precedes the first line. 
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UP - Move Line Pointer Up 

UP moves the current line pointer (^) toward the start of the 
data set . 

Syntax 



UP 



count 



Requ i red : None 

Defaults: Count defaults to 1 

Alias: U 



Operands Descr i pt i on 

count The number of lines that the current line pointer 
(?() i s to be moved . 



c 



Example 
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VERIFY - Display Changes on Terminal 

VERIFY causes the changes you made to be shown on the terminal 
(0N)> or not shown (OFF), Verification is off until it is 
invoked the first time during an edit. 

Syntax 



VERIFY 



ON/OFF 



Requ i red : None 
Defaults; ON 
Alias: V,VE 



Operands Descr i pt i on 

ON Each time the position of the current line pointer 

( 5f ) changes^ the line to which it moves should be 
printed. In addition* modifications made in fields 
of records using the 'character -string' or 'text' 
forms of the CHANGE subcommand are verified. 



OFF 



Changes of the position of the current line pointer 
(^)» and of fields of records by means of the CHANGE 
subcommand, are not to be verified. 



Example 



V ON 
V 

V OFF 
VERIFY 



202 SC34-0313 



O 



$EDIT1 and SEDITIN 



Line Editing Commands 



The line editing commands alloM a single line to be added> 
replaced, or deleted from the data set being edited. 

Note t Line editing functions are not subcommands. 

Syntax 



line-number character-str i m 

Required: line-number 
Defaults: None 



Note : If specified, 'character-string* must be 
separated from * 1 1 ne-number ' by a single blank 
or tab . 






Operands Descr i pt i on 

1 i ne-number 

'line-number* with an immediate carriage return 
deletes the line having the specified number (it 
does nothing if the line does not exist). 

'Line-number', followed by a character string, adds 
the string to the data set. If a line havingthe 
specified number already exists, it is replaced* 

character-string 

The text of the line to be added. 
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Examples 

Add Line (Line *123^5 does not exist) 



^> 



123^5 This line is being added 



Delete Line 123^5 



123^f5 



Replace line 123^5 



12345 This line replaces 12345 
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$FONT - PROCESS ^978 CHARACTER IMAGE TABLES 



$FONT, a special purpose utility* creates or modifies charac- 
ter image tables for the ^978 display station. Each character 
image is defined by a dot matrix that is coded into eight bytes 
of data. The entire table of codes requires 20^8 bytes of stor- 
age. For details on the associated ^978 hardware, see the Bib- 
liography for the 4978 Display Station manuals. 

$FONT requires one preallocated data set of 20'i^8 bytes (8 
records). The data set can contain a character image table, or 
it can represent storage for a new table to be constructed. 



$FONT Commands 



The commands available under $FONT are listed below. To display 
this list at your terminal, enter a question mark in response 
to the prompting message COMMAND (?):. 



COMMAND (?): ? 

DISP — DISPLAY TABLE 
EDIT -- ENTER EDIT MODE 
SAVE — SAVE TABLE 
PUT — LOAD TABLE INTO 
GET -- READ TABLE FROM 
END — END PROGRAM 

COMMAND (?): 



DEVICE 
DEVICE 



After the commands are displayed, you are again prompted with 
COMMAND (?):. You respond with the command of your choice (for 
example , DISP) . 

DISP - Display Table 

The character images defined by the table are displayed along 
with their associated EBCDIC codes. 

EDIT - Enter Edit Mode 

Edit mode enlarges the display for modification of the dot 
matrix patterns (a complete description of the edit mode func- 



Chapter ^, The Utilities 



205 



SFONT 



tions is given following this section). 

END - End Pr-ogram 

When you enter the END subcommand, the system displays the mes- 
sage SAVE TABLE? if edit mode has been entered at least once 
since the last SAVE operation. This allows you to save the cur- 
rent table, if desired, before ending the program. 

GET - Read Table from Device 

The image store is read from a (4978) terminal and becomes the 
current table. The GET command followed by SAVE provides a 
means for initializing a data set with a character image table. 

PUT - Load Table into Device 

The current table is written to the image store of a (<^978) ter- 
minal. A terminal name can follow the command on the same line, 
or you are prompted for it. The image store is a table which 
contains codes for generating characters or images for the <^978 
termi na 1 . 

SAVE - Save Table 



The current table, reflecting any changes made during 
mode, is written to the data set designated at load time. 



edit 



Edit Mode 



When you enter edit mode, a 4X8 grid is displayed in the center 
of the screen. For each grid row, the centers of seven overlap- 
ping dot areas occur at the centers of each of the four squares 
and at each of the three interior grid lines. (See 4978--1 Pi s~ 
pla y Station and Attachmcint General Informatio n for details on 
the character matrix.) Dots are represented with the following 
pattern * 
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Screen Format 



The following complete screen format appears after you select a 
character for display: 



^,^ 





PFl — TAB FORWARD 
PF2 -- TAB BACK 
PF3 — NEXT LINE 
ppct — INVERT DOT 
ENTER — SET PATTERN 
PF5 — COMMAND MODE 

CODE A (CI) 

• • 


• « 

• • • • 

A 


• • 
• • • • 
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Character Image Displav and Modification 



if \ 

^4, > 



You can display and modify the character images as follows? 

1. Specify the character to be viewed either by entering a 
character at the cursor position (the alphanumeric field)* 
or by entering the hexadecimal representation of the 
EBCDIC code between the parentheses (the hex field). 

2. Press the ENTER key. The character image* as determined by 
the table designated at load time* is displayed on the 
grid. For ^978 terminals, the image is also displayed 
beneath the grid in normal dimensions. If the character 
was designated with an alphanumeric field entry, then the 
EBCDIC code as determined by the keyboard in use is dis- 
played in the hex field. 

3. The program function keys can then be used according to the 
displayed instructions to modify the dot pattern. Note 
that adjacent or overlapping dots appear as a continuous 
solid line on the grid. This reflects a feature of the 
character generation hardware on the A978 display. 



When the desired pattern has been constructed, press 
ENTER. The word CODE on the code entry line changes to SET, 
displayed at high intensity. At this point, press ENTER 
again and the new pattern replaces the existing pattern for 
the specified code. To associate the pattern with a new 
code, alter either the alpfiabetic or hex field before 
pressing ENTER. 



V,: 
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$FSEDIT - FULL SCREEN EDITOR 



$FSEDIT is a full-screen text editing utility that helps you 
develop and modify programs. It operates the terminal bs a 
static screen device and therefore must be run from a terminal 
with static screen capability (<!t978/4979 ) . 

With $FSEDIT you can: 

• Edit programs using a full screen 

• Scroll information forward and backward 

• Use PF (program function) keys for frequently used func- 
t i ons 

• Insert a mask for prefilling inserted lines 

• Merge data from other data sets 

• Communicate with a System/ 370 in conjunction with the Host 
Communication Facility lUP installed on the host 
System/370 

Note; To use $FSEDIT, the modules $FSUTIL, $FSUTLN, $FSHELP 
and $FSIM1 to $FSIM8 muist reside on the system IPL volume. 



Data Set Requirements 



$FSEDIT requires a preallocated work data set for use as a text 
edit work area. This work data set is automatically allocated 
if $FSEDIT is invoked by the session manager. If you use the $L 
command* you can provide the name of the work data set when you 
enter the load request* or when $FSEDIT issues a prompt for the 
name of the work data set. 

Text data (source statements) within this work data set are in 
a special text editor format* identical to that used by the 
$EDIT1N text editor. See "Data Set Requirements" on page 169. 
Data within a work data set can be edited by either $EDIT1N or 
$FSEDIT. 

Note ; $FSEDIT uses source data sets of 80-character lines that 
are line numbered in positions 73-80 for host or Series/l data 
sets or in positions 1-6 (COBOL convention) for host data sets. 
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When you end a text editing utility session? save the contents 
of the work data set in a source data set on disk* diskette or 
tape. If a new data set is used? a prompt is issued asking if 
the work data set is to be written to the same disk* diskette* 
or tape it was read from. If your response is N> a prompt is 
issued asking for a new data set to be used. If the data set 
does not exist on the volume specified* $FSEDIT creates it 
automatically. Automatic translation from text editor format 
to source statement format is performed. 

Caution* If you write the work data set out to a multifile 
tape, all files following this data set will no longer be 
access i ble . 



Scrolling 



During editing and browsing, the information to be displayed 
usually exceeds the size of the display screen. Scrolling 
allows you to page up or down through the information. Two PF 
keys are used for this purpose — one for each direction. When- 
ever scrolling is allowed, a scroll amount, displayed at the 
end of the second line of the display, shows the number of lines 
scrolled with each use of a scroll key. 

PAGE or P Specifies scrolling one page (22 lines). 

HALF or H Specified scrolling a half page (11 lines). 

MAX or M Specifies scrolling to the top or bottom of the data 
set . 

n Specifies number of scrolling lines 

You can change the scroll amount by moving the cursor to the 
scroll field and overtyping the amount currently displayed. To 
change the scroll amount, type over the first character with a 
P, H or M to change the scroll amount to a page* half page, or 
maximum, respectively. To specify a number of lines to scroll, 
overtype the field with the number of lines desired. 

In browse mode, the scroll amount is initialized to PAGE; in 
edit mode, it is initialized to HALF. When you make a change, 
the new value remains in effect for the remainder of the 
session unless you change it. The value for MAX is an 
exception? following a MAX scroll, the scroll amount defaults 
back to the initial value. 



\. 
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Program Function Keys 



The ATTN and six program function keys are used to request com- 
monly used or special $FSEDIT operations as follows: 

PFl Redisplays the screen image. All changes are ignored 
and the original data is displayed. 

PF2 SCROLL UP scrolls up the amount shown in scroll amount 
field. 

PF3 SCROLL DONN scrolls down the amount shown in the 
scroll amount field. 



PF^ REPEAT FIND repeats the action of 
FIND primary command. 



the 



pre V 1 ous 



PF5 REPEAT CHANGE repeats the action of the previous 
CHANGE primary command (Applies only to edit mode). 

PF6 PRINT SCREEN prints the screen image on the system 
printer C$SYSPRTR). The use of PF6 for hardcopy may 
have been changed by use of the TERMINAL HDCOPY state- 
ment (see the System Gu i de ) . 

ATTN CA Cancel the list option. Pressing the ATTN key and typ- 
ing CA stops the list option of $FSEDIT and returns to 
the primary option selection list. 

Note : The PF2 - PF5 keys are active only during browse and edit 
modes. PFl use is only meaningful during edit mode. 
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SFSEDIT Options and Command Summary 



(T^- 



y 



This summary shows the options and commands 
$FSEDIT. A description of each follows. 



avai lable under 



Pr i mary Opt i ons : 

BROWSE - Display Data Set 
EDIT - Edit Data Set 
END - Terminate $FSEDIT 
HELP - Display Commands 
LIST - Print Data Set 
MERGE - Merge Data from a 
READ - Retrieve Data Set 
SUBMIT - Submit Job to Host 
WRITE - Transfer Data Set to 



Source Data Set 
From Native/Host 



Nat i ve/Host 



BROWSE Primary Commands: 

END - Same as MENU 

FIND - Find a Character String 

LOCATE - Find Data by Line Number 

MENU - Return to Primary Option Menu 



EDIT Primary Commands: 

CHANGE - Modify Character Strings 

CLEAR - Clear Work Data Set 

END - Return to Primary Option Menu 

FIND - Find Character String 

LOCATE ~ Find Data by Line Number 

MENU - Return to Primary Option Menu 

RENUM - Renumber Data Set 

RESET - Clear Line Commands 



EDIT Line Commands: 

A»B - Define Copy/Move Destination 

CCC - Copy Lines of Text 

COLS - Display Columns 

D,DD - Delete Text 

I » I I - Insert Text 

M»MM - Move Line of Text 

MASK -- Display Insert Mask 



%^ 



c 



212 SC3^-0313 



$FSEDIT 



o 



Primary Option Menu 



When $FSEDIT is loaded^ the following primary option menu 
(selection list) is displayed. To select the desired function* 
enter the number of the option in the *Select Option* input 
field. 



$FSEDIT PRIMARY OPTION MENU 

SELECT OPTION ===> 1 

1 BROWSE - DISPLAY DATASET 

2 EDIT - CREATE OR CHANGE DATASET 

3 READ - READ DATASET FROM HOST/NATIVE (H/N) 
^ WRITE - WRITE DATASET TO HOST/NATIVE (H/N) 

5 SUBMIT - SUBMIT BATCH JOB TO HOST SYSTEM 

6 LIST - PRINT DATASET ON SYSTEM PRINTER 

7 MERGE - MERGE DATA FROM A SOURCE DATASET 

8 END - TERMINATE $FSEDIT 

9 HELP - DISPLAY TUTORIAL 



"N, 



Option 1 - BROWSE 

The BROWSE mode allows you to display and examine a source file 
in the work data set» but prevents the possibility of changing 
it. 

In this mode» you can view all parts of the work data set using 
the scrolling function (invoked by pressing PF keys). 

In addition* two primary commands are used to locate specific 
information within the data set. 

FIND Searches for a designated text string 

LOCATE Searches for a designated line number. 

These primary option commands are discussed under "Primary 
Commands" on page 218. 

During browsing, the current number of lines in your data set 
and the maximum number of lines the work data set can hold is 
displayed on tlie top line of the display* following the data 
set name and the volume identification. (The maximum number of 
lines is displayed in parentheses.) 
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Browsing is terminated by entering the primary command MENU in 
the command input field to return to the Primary Option Menu, 

Option 2 - EDIT 

In the edit mode» you can modify an existing source data set or 
create a new one. To do this* you uses 

• Program function keys for two-way scrolling and repeat 
change and f i nd 

• Primary commands (CHANGE, CLEAR, END, FIND, LOCATE, MENU, 
RENUM, and RESET) 

• Line edit commands to manipulate whole lines or blocks of 
1 i nes . 



Creating a Source Data Set 



To create a new source data set, you enter EDIT mode (option 2 
of the primary option menu) with an empty data set (the work 
data set specified when $FSEDIT was invoked). Because the work 
data set is empty, the editor assumes insertion (creation) of 
lines is desired and the INSERT function is active. Following 
is an example of the initial display when editing an empty data 
set. 



^■v...y 



EDIT EDITWORK, EDX002 0(2'«f) COLUMNS 001 072 

COMMAND INPUT ===> SCROLL ===>HALF 

^9(*?e^ ¥:^^^i^ TOP OF DATA J(X9f?€)f9fXX9f jfxj^^jf ^^^^jf X9(XJ(^jf ^^^5f )t)«^ 



xx?f9f^ ^^j(^ BOTTOM OF DATA *5f )f )ejfxx^?t*^?ejfxx^9(?f?(X9(549f^)(x^5(9(9f 



The top line of the screen, from left to right, displays utili- 
ty mode (EDIT), the name and volume of the work data set 
( EDITWORK , EDX002 ) , the number of source statements in the work 
data set, and in parentheses, the total number of statements 
the data set will hold. 

The cursor is positioned at character position 1 of the insert 
line. After you enter information on this line, press the 
ENTER key to write the data on the screen to your work data set. 



214 SC34-0313 



$FSEDIT 



o 



The utility then numbers the entered line and sets up 
next insert line. 



for the 



As you continue in this manner, a new insert line is readied 
each time the preceding line is entered (ENTER key). The insert 
(creation) operation is terminated by pressing the ENTER key 
without entering anything on the new insert line. 

Note : §FSEDIT does not distinguish between input mode and edit 
mode during editing operations and data on the screen can be 
changed at any time. 

To save the source statements just created, return to the pri- 
mary option menu (using the MENU command). Use the WRITE option 
to save the newly created data set. You are prompted for the 
name of the target data set and volume. 



Modifying an Existing Data Set 






To modify (edit) an existing data set, it must first be read 
into the work data set using option 3 (READ) of the primary 
opt i on menu . 

Once your data set has been read into the work data set, you can 
locate and change information by scrolling the data set by 
pressing the PF keys. The PF keys and definitions are described 
under "Program Function Keys" on page 211. 

To modify data on the screen, move the cursor to the desired 
location and enter the new information. Several lines can be 
changed before pressing the ENTER key. A single line or blocks 
of lines can be deleted, inserted, duplicated, or rearranged 
using the edit line commands. These are discussed under "Edit 
Line Commands" on page 226. 

For general editing purposes, primary edit commands are used to 
find and change designated character strings and to change the 
line numbering sequence. These commands are discussed under 
"Primary Commands" on page 218. 

After you finish modifying the data set, use NRITE to save the 
data in the same data set it was read from or to a new data set 
on disk or diskette. 

Editing is terminated by entering the primary command END or 
MENU in the command input field, which returns you to the pri- 
mary option menu. 
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Option 3 - READ 

TheREAD option retrieves a data set from either a host system 
or a data set on disk* diskette* or tape on the native 5eries/l 
system and stores it in your work data set. The primary option 
menu remains on the display and the area below it is used to 
prompt for the data set name and to provide information. The 
data set name entered must be fully qualified and must contain 
fixed length 80--byte records. 

Line numbers for native data sets must be in columns 73-80, For 
host data sets* line numbers can be in either columns 1-6 or 
73-80. If the line numbers in the data set exceed the maximum 
allowed by $FSEDIT (32767), the data is automatically renum- 
bered with a smaller line number increment. 



When the READ is completed or terminated because of an error, 
the number of lines transferred, or the appropriate error mes- 
sage* is displayed and the cursor is moved to the 'Select 
Option' input field. This indicates the completion of the READ 
function and another option can be selected. The READ to host 
requires the Host Communications Facility on the System/370. 

Option <i -^ WRITE 



The WRITE option transfers the contents of the work data set to 
a host /native data set. A prompt is issued asking if the work 
data set is to be written to the same disk, diskette* or tape 
data set it wss read from. If the response is NO (N), a prompt 
is issued asking for a new data set to be used. If tfie data set 
does not exist on the volume specified, it is created automat- 
ically. The WRITE to host requires the Host Communications 
Facility on the System/37 0. 



\^-.j^ 



Hote t The WRITE option does not destroy the contents of the 
work data set. Therefore, the WRITE option can be directed to 
another data set to obtain a backup copy. The WRITE option can 
also be used following further editing of the work data set. 

Caution. 

1. If you increase the contents of the work data set so that it 
is too big to be written back to the source data set* 
$FSEDIT deletes the source data set and attempts to reallo- 
cate it with enough space to save the work data set con- 
tents. If the allocation fails* the original source data 
set is lost. However* the work data set remains intact and 
can besaved in a suitable source data set, 

2. If you write the work data set out to a multifile tape, all 
files following this data set will no longer be accessible. 
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The SUBMIT option injects a job (JCL and optional data) into 
the host job stream. The display and operation aresimilar to 
the READ and WRITE commands. The data set name entered must be 
the fully qualified name of the host data set containing the 
JCL to be submitted. If the keyword DIRECT is entered instead 
of a data set name, tlie contents of the work data set are trans- 
ferred directly into the host job stream. The SUBMIT to host 
requires the Host Communications Facility on the System/ 370. 



Note : The DIRECT option 
HASP or JES2 interface. 



is only to be used in systems with a 



Option 6 - LIST 

The LIST option prints the entire contents of the work data set 
on the hardcopy device assigned to the terminal. (The listing 
can be terminated at any time by pressing the ATTN key and typ- 
ing CA. ) 

Option 7 - MERGE 

The MERGE option merges all, or part, of a source data set into 
the current edit work data set. You are prompted for the names 
of the Series/l source data set and volume. If the specified 
data set is found, you are then prompted for the first and last 
line numbers of the data to be copied. If the entire data set 
'- to be merged, an *^' can be entered instead of the line num- 



cations is incorrect, an error message is displayed and you are 
prompted for the data again.) If all parameters are correct, 
the data is then read from the source data set, added to the 
current work data set and the current work data set is renum- 
bered . 

To cancel the MERGE function, press the ENTER key when prompted 
for MERGE FROM data set name. 

C auti on : Once the merge has started, it must be allowed to 
complete normally or unpredictable results may occur. 
Series/l source data sets are defined to consist of 80 charac- 
ter lines which are numbered in columns 73-80. 



Chapter ^, The Utilities 



217 



$FSEDIT 

Opt ion 8 - END 

The END option terminates $FSEDIT, 

Option 9 - HELP 

The HELP option displays tutorial text on the use of $FSEDIT 



Primary Commands 



Primary commands are entered on line 2 of the display in the 
Command Input Field. All primary commands can be entered while 
in edit mode. In browse mode» three primary commands are 
recognized by $FSEDIT: LOCATE, FIND, MENU. 

Most of the primary commands can be entered in abbreviated for- 
mat. Only the first character is required. Minimum free form 
format is indicated with each command enclosed in (). 

The function of each of the primary commands is described on 
the following pages. 



''K.-r.-j^ 
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C (CHANGE) - Change Text (Edit Mode Only) 

Changes text strings. The search for the 'textl' string 
proceeds until the string is found or the bottom of the data set 
is reached. If found, 'textl' is replaced with 'text2'. If the 
two text strings are not the same length, automatic shifting is 
performed by expanding or collapsing blank characters at the 
end of the line. If insufficient blanks exist for shifting 
right without shifting a non -blank character into column 72, 
the change is not made and the line is displayed with an error 
message in the line number field. (If the ALL option was 
selected, the change is terminated at this point.) If the 
"textl' string is not found, you are notified with an error 
message displayed on the top line of the screen. PF5 would 
repeat the previous CHANGE specification. 

Syntax 






CHANGE /textl/text2/option 
C /textl/text2/opt i on 

Required: /text l/text2/ 
Defaults: option defaults to 



'NEXT' 



Operands Descr i pt i on 

/textl/text2/ 

The delimiter (/) can be any alphanumeric character 
except blank. It is not part of, and cannot appear 
in, the character strings 'textl* and *text2'. All 
three delimiters are required and all must be the 
same character. 'textl' and 'text2* can be any 
character string not containing the delimiter used. 

option Defines the beginning and the extent of the search. 
The following are valid options: 

NEXT 

Locate and change the next occurrence of 'textl' to 
'text2''. The search starts with the first line 
d i sp layed . 

FIRST 
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Locate and change the first occurrence of *textl' 
beginning the search at the first line of data set. 






ALL 

Locate and change all occurrences of 'textl* begin- 
ning at the first line of the data set. 



( . ' 



J 
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CL (CLEAR} - Clear Mork Data Set (Edit Mode Only) 

Clear the work data set. 

Syntax 



CLEAR 
CL 

Required: none 
Defaults: none 



No operands are required. 



E (END) - End Primary Command Input 

Return to Primary Option Menu. The END command terminates edit 
or broMse mode and returns to the Primary Option Menu screen. 

S yntax 




No operands are required. 
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F (FIND) - Find Text String 



Find and display text strings. The search proceeds until the 
text string is found or until the end of the data set is 
reached. If the string is found* automatic scrolling takes 
place to display the line containing the text string to be dis- 
played at the top of the data area of the display. If the 
string is not found* you are notified. PF4 repeats the previ- 
ous FIND specification. 

Syntax 



FIND /text/ option 
F /text/ option 

Required? /text/ 

Defaults: option defaults to *NEXT 



Operands 
/text/ 



opt i on 



Description 

The delimiter (/) can be any alphanumeric character 
except blank which does not appear within the text 
string. Both delimiters are required and must be 
the same character. 



^4 X 



Defines the beginning 
opt i ons are : 

NEXT 



of the search. The valid 



The search starts with the first line of the current 
di splay . 

FIRST 

The search starts at the first line of the data set. 
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L (LOCATE) - Locate Line Number 

Locate and display the requested line number. The data set is 
searched for the requested line. If found* automatic scrolling 
takes place and the requested line is displayed at the top of 
the display. If the requested line number does not exist* an 
error message is displayed. 



Syntax 



LOCATE line-number 
L line-number 



Requ i red : 
Defaults : 



1 i ne-number 
none 



Operands Descr i pt i on 
1 i ne-number 

The number of the line to be located and displayed. 

M (MENU) - Return to Primary Option Menu 

Return to Primary Option Menu. The MENU command terminates 
edit or browse mode and returns to the Primary Option Menu 
screen . 




No operands are required. 
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R (RENUM) - Renumber Data Set (Edit Mode Only) 
Assign new line numbers to each line of the data set 
Syntax 



RENUM first increment 
R f i rst i ncrement 

Requ i red J none 

Defaults: first and increment default to 10 or to 
the values last used. 



Operands Descr i pt i on 

first The number to be assigned to the first line of the 
data set . 



increment The increment to be used in generating line 
numbers , 

Note : If the number of lines in the data set is so large that 
the maximum line number of 32767 is exceeded, the 'first* and 
* increment* values are automatically reduced until the data 
set can be properly renumbered. 



,4' 



'x-.y 
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RESET - Reset Line Commands (Edit Mode Only) 



The RESET command can be used to reset erroneous or unwanted 
line commands^ to reset line numbers to normal after they were 
replaced with ERR messages and to terminate the display of the 
MASK line. 

Syntax 



RESET 

Requ i r ed : none 



No operands are required. 
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Edit Line Commands 



The edit line commands are used to delete^ inserts duplicate* 
or rearrange a single line or agroup of lines* Theyare valid 
only i n ed i t mode . 

Single character line commands operate on single lines of data 
and are specified by entering the line command in the first 
position of the line preceding the line number. 

Double character line commands operate on blocks of data and 
are specified by entering the block command in the first two 
positions on the first and last line of the block of data. 

A (After) and B (Before) 

Defines the destination for a copy or move operation. The *A* 
and 'B* line commands are entered to define the destination of 
a copy or move operation. The "A* defines the destination as 
being after tlie line and the 'B' defines the destination as 
being before the line. Thus it is possible to move or copy any- 
where in the dsta set* including before the first line or after 
the last line. 



C (Copy Line) and CC (Copy Block) 

Duplicate lines of data within the data set. The procedure for 
duplicating lines is the same as for moving except that the 'C 
or 'CO* replaces the 'M' or *MM*. The copy operation leaves the 
original data intact and inserts a duplicate copy of the data 
at the destination specified. The entire data set is renum- 
bered at the completion of the copy operation. 



/- 
W 
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Example 

Copy Block 



EDIT EDITWORK, EDX002 2( 2«^) COLUMNS 001 072 

COMMAND INPUT ===> SCROLL ===>HALF 

xx^?(^ x)f?f?fx TOP OF DATA ?f )^x^?f ^^?«^^)^^^^^^9f^^^^^x^X9(^^x^?f9f 

CCOOOIO LINE 1 

CC00020 LINE 2 

B^^^^ ^^^^ BOTTOM OF DATA ^?(^J(^xxx^^?e^^9f ^?fX9(^^?t^^^jt*j(*^^ 



Screen image after Block Copy 



EDIT EDITWORK, EDX002 ^i 2^)-BL0CK- DATA RENUMBERED 

COMMAND INPUT ===> SCROLL ===>HALF 

x)(?(?f5( ^^9(^x TOP OF DATA x^9(5(^jf^^xj(^^x^9^^9(?t?fx^x^?(x^xx^^^x 

0010 LINE 1 

00020 LINE 2 

00030 LINE 1 

000^0 LINE 2 
)(xx?^?f ^^^¥: BOTTOM OF DATA ^^^^^9«)(^^^^^J(^^^?«^XJf949f ^^9fx^*)fx 
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COLS - Display Columns 

The COLS command are used to display a line showing column num- 
bers. To display the column numbers? type COLS starting in the 
left margin of the line where the display is desired. 



D (Delete Line) and DD (Delete Block) 

Delete a line? or a block? of data. A 'D* on a line causes the 
line to be deleted when the ENTER key is pressed. More than one 
line can be deleted by entering a * D * on each line. The *DD* 
line commands are used to delete a block of data. The 'DD* is 
entered on the first and last line of the block of code to be 
deleted. The first line of the block does not have to be on the 
same display page as the end of the block (scrolling can take 
place between defining the two 'DD* lines). The block of data 
is deleted when the ENTER key is pressed the first time after 
both *DD* lines have been specified. 

Example 

Delete Block of Lines 



EDX002 



7( 



2^) 



DATA 



- COLUMNS 001 072 
SCROLL ==: = >HALF 



EDIT EDITWORK, 

COMMAND INPUT ===> 
?f^^^^ x^^^^ TOP OF 

00010 LINE 1 
DD00020 LINE 2 

00030 LINE 3 
DDOOO<^»0 LINE ^ 

00050 LINE 5 

00060 LINE 6 > 

00070 LINE 7 
^^^^9f *^5fx BOTTOM OF DATA 5f Jt^?f?f^K9(^9(jf)(J(?f9()^?(*^xj(^H^9()eKJf^?f 



X.V 
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I Screen Image after Block Delete 



EDIT EDITWORK, EDX002 7( 2^ )-BLOCK-DATA RENUMBERED 

COMMAND INPUT ===> SCROLL ===>HALF 

^^K)(9t ^^^¥i^ TOP OF DATA ^^^^*m^^^i^¥:ii^¥:^^i(^^^^i^^^^¥:^¥:^¥:¥:^ 

00050 LINE 5 
00060 LINE 6 
00070 LINE 7 
*)fxx^ ^)fX5f BOTTOM OF DATA ii^^^^^^^¥:^^^^i^^^^im^ii^^¥:^^mm^ 



I (Insert) - Insert Neu Line 






Causes a new line to be inserted after this line. Any informa- 
tion typed on the inserted line is assigned a line number and 
becomes part of your data when the ENTER key is pressed. If the 
line number assigned to the newly inserted line is equal to» or 
greater than* the line number of the next sequential line* all 
data to the end of the data set is automatically renumbered. If 
no information is entered* the inserted line is automatically 
deleted the next time the ENTER key is pressed. If information 
is entered on the inserted line and the cursor is still on the 
inserted line when the ENTER key is pressed* another new line 
is automatically inserted. This allows line after line to be 
generated in a continuous insert mode. The cursor is set to the 
first position where data appears in the following line. 



The inserted line duplicates the current value of the edit mask 
line. The initial value of the mask line is 72 blanks. It can be 
changed at any time as noted in the description of the MASK com- 
mand . 

Note I The I line command can be entered on the TOP OF DATA mes- 
sage line to insert a line ahead of what is currently the first 
line. It is typed in the first position of the TOP of DATA 
line. 
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Example 

I Line Command 



EDIT EDITWORK, EDX002 2( 24) COLUMNS 001 072 

COMMAND INPUT ===> SCROLL ===>HALF 

I^x^?f X5f^^ TOP OF DATA ^^^^^9f )f5f^x?«jf^?«^x^^^X9(9f^9^^^^?f9f x^^^ 

00010 LINE 1 

00020 LINE 2 
?f9f^)fx ^^^¥: BOTTOM OF DATA ^^^5f^^^^x^^^^^?t?f?(^^^?e)?x^jf^?f?f?(9f 



Screen Image After I Line Command 



EDIT EDITWORK, EDX002 2( 24) COLUMNS 001 072 

COMMAND INPUT ===> SCROLL ===>HALF 

^?f^xx ^¥:^^^ TOP OF DATA XH)()fX9f ?f J(?f^X)fXX9fx?(^?f 9t*^j(?t9(9t*^^9e^?f 



00010 LINE 1 
00020 LINE 2 
Hii^^i^ ^ii^^ BOTTOM OF DATA ^X5^?e?f Jf 9(Jf^)(^M^?f^)f jf ?f?f ?(x^^^^?f^x5(9f 



\M 



\^ 
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II (Insert Block) - Insert Block of Lines 

Insert a block of neN data. The line with the II command is 
displayed at the top of the display with twenty-one inserted 
lines following it. Data can be entered on all twenty-one 
lines before entering it with the ENTER key. The new data is 
then saved as with the 'I* command. If all inserted lines have 
data entered on them and the cursor is left on the last line of 
the display when the ENTER key is pressed* another twenty-one 
lines are generated. If data are not entered on one or more of 
the lines* the unchanged lines are deleted and the insert mode 
is terminated. 



Notes ? 



The II command can be entered on the TOP OF DATA message 
line to insert data in front of what is now the first line. 
It is typed over the first two asterisks of the TOP OF DATA 
line. 






The II command is different from the rest of the double 
character line commands in that it is entered on only one 
line and generates a block of new data instead of operating 
on a block of data. 

The inserted lines duplicate the current value of the edit 
1 i ne mask . 



Example 

Block Insert Line Command 



EDIT EDITWORK, EDX002 2( 2^) COLUMNS 001 072 

COMMAND INPUT ===> SCROLL ===>HALF 

^^34?(x x^MJf^ TOP OF DATA *f J^xj(^^xxxx9(9ex^?(jf)f Jt^x^^f xx9«)f ^^j^x^^ 

00010 LINE 1 
II00020 LINE 2 
)fx^?«9( x^xx BOTTOM OF DATA )f^^X)fxx)(?f }f MX^H?f^^^)(^^9(^?f9f 3f )6^x)€ 



Chapter 4. The Utilities 



231 



SFSEDIT 



Screen Ima ge After Bl ock Insert C ommand 



EDIT EDITWORK, EDX002 

COMMAND INPUT ===> 
00020 LINE 2 



2( 24) COLUMNS 001 072 

SCROLL ===>HALF 



MASK ~ Display Insert Mask 



The MASK line command is used to display the insert mask which 
is used to prefill inserted lines. The insert mask is 72 bytes 
long and is initialized to all blanks at the beginning of the 
session. Any data filled into it remains in effect for the 
remainder of the current session unless changed by you. The 
insert mask can be changed any time it is displayed by overtyp- 
ing it with the desired information. 



\^J 



Note : To display the insert mask requires that all four charac- 
ters of the MASK line command be entered by overtyping the 
first four characters of the line number. 
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M (Move Line) and MM CMove Block) 



Move a line» or block of lines» from one location to another. 
When a *M* line command is entered* a single line is moved to 
the location specified by an *A' or 'B' line command. The 'MM' 
line commands cause the block of data defined by the two 'MM' 
line commands to be moved to the location specified by an 'A' or 
'B' line command. The moved lines are removed from their ori- 
ginal location and the entire data set renumbered after the 
move. The move occurs when the ENTER key is pressed the first 
time after both the lines to be moved and the destination are 
defined. The destination does not have to be on the same page 
of the display as the move line command(s) and the two 'MM' line 
commands can also be separated. 

Example 

Move Block of Lines 



EDIT --- 


- EDITWORK, 


COMMAND 


INPUT ===> 


A^^^^ ^^9f^^ TOP OF 


00010 


LINE 


1 


00020 


LINE 


2 


00030 


LINE 


3 


MMOOO<+0 


LINE 


4 


00050 


LINE 


5 


MM00060 


LINE 


6 


00070 


LINE 


7 


^^^^^ ii^^¥: BOTTOM 



EDX002 



7( 



2*^) 



DATA 



- COLUMNS 001 072 
SCROLL = = =:>HALF 



OF DATA ?f^Jf ?f^^^X9f^)f )f3fHJ(^?6Jf^)fx?^)(x?f Jf J(9f?f Jf 
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Screen Image After Block Move 



EDIT --- EDITWORK, EDX002 7( 24 ) -BLOCK-DATA RENUMBERED 
COMMAND INPUT ===> SCROLL ===>HALF 

?f^x9^* ^?f^^^ TOP OF DATA ^?f ^^e^f Jf^^xjf^^jf^f )f )(9(^j(*^^^?f^)f jf?f j(je^^ 

00010 LINE ^ 

00020 LINE 5 

00030 LINE 6 

00040 LINE 1 

00050 LINE 2 

00060 LINE 3 

00070 LINE 7 
^)f)f9€Jf =)k¥:¥:}k BOTTOM OF DATA ^^^J(M?(^jf9f^^X9f?e>f^^je?(^x?ex?f^3(^^^x 
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$IAMUT1 - BUILD AND MAINTAIN INDEXED DATA SET 



$IAMUT1 helps you manage your indexed data sets. The $IAMUT1 
utility is shipped with an input/output buffer of 512 decimal 
bytes. This allows you to define an indexed data set with a max- 
imum block size of 512 bytes* and to load, unload, and reorgan- 
ize indexed data sets with a maximum record size of 512 bytes. 
If you want to change the maximum record size, refer to the 
Program Directory for use with Version 1, Modification level 1 
of program 5719-AM3, section J, Programming Considerations 

$IAMLIT1 can be invoked using the $L command, $JOBUTIL* or the 
Session Manager. 



$IAMUT1 Commands 



The commands available under $IAMUT1 are listed below. To dis- 
play this list at your terminal, enter a question mark in 
response to the prompting message COMMAND (?):. 






ENTER COMMAND (?): ? 

CR - INVOKE $DISKUT1 

EC - SET/RESET ECHO MODE 

EN - END THE PROGRAM 

SE - SET DEFINE PARAMETERS 

DF ._ DEFINE AN INDEXED FILE 

DI _ DISPLAY CURRENT SE PARAMETERS 

RE _ RESET CURRENT VALUES FOR DEFINE 

LO - LOAD INDEXED FILE FROM SEQUENTIAL FILE 

RO - REORGANIZE INDEXED FILE 

UN - UNLOAD INDEXED FILE TO SEQUENTIAL FILE 

ENTER COMMAND (?): 



After the commands are displayed, you are again prompted with 
COMMAND (?):. You respond with the command for of your choice 
( for example , EC) . 
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CR - Create Data Set 

CR allocates space for your data set in a volume by internally 
invoking the $DISKLIT1 utility. The SE command should have been 
used to determine the number of records to allocate. When CR is 
entered on a terminal* the $DISKUT1 utility is loaded. You can 
then use the AL command of $DISKUT1 to allocate a data set; any 
other $DISKUT1 function can also be performed. Communication 
to the $DISKUT1 utility continues until the END command (EN) is 
entered, at which time communication to $IAMUT1 is restored. 
For information on the $DISKUT1 utility, refer to "$DISKUT1 - 
Allocate/Delete; List Directory Data" on page 135. 

Note : Echo mode is not active during use of $DISKUT1. 

The following example shows a use of the CR command: 



ENTER COMMAND (?) : 
$DISKUT1 ACTIVE 
USING VOLUME EDX002 



CR 



COMMAND (?): AL SAMPLE! 
HOW MANY RECORDS? 72 
DEFAULT TYPE = DATA - OK? 
SAMPLEl CREATED 

ENTER COMMAND (?): 
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DF - Define Indexed Data Set 



DF command defines an indexed data set using an existing data 
set and the information you specify. Nhen DF is entered* you 
are prompted for the immediate write back option and the names 
of the data set and volume to be formatted. Size calculations 
are made and the data set is formatted. The size calculation 
information is returned to you at your terminal on completion 
of the DF command. Before entering DF» you must use the SE 
command to set up parameters that determine the size and format 
of the indexed data set. The data set must have been allocated 
previously (the CR command can be used to allocate it). 

DF alloMS you to select the immediate write back option. With 
this option» each modification to the indexed data set records 
that is the result of your request to update a data record is 
written to the data set immediately* thus contributing to the 
integrity of the data set. If you enter N to the immediate write 
back prompt* modifications are held in the main storage buffers 
for a period of time before being written back to the indexed 
data set. In most cases* not using the immediate write back 
option often results in fewer I/O operations and in better per- 
formance. 






The following example shows a use of the DF command: 



ENTER COMMAND (?): DF 

DO YOU WANT IMMEDIATE WRITE-BACK? N 

ENTER DATASET ( NAME * VOLUME ) : SAMPLEl, EDX002 



After entering the above information* the following 
played ' 



is d i s- 
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.TOTAL LOGICAL RECORDS/DATA BLOCK: 


3 


FULL RECORDS/DATA BLOCK: 


2 


INITIAL ALLOCATED DATA BLOCKS: 


1 


INDEX ENTRY SIZE: 


32 


TOTAL ENTRIES/INDEX BLOCK: 


7 


FREE ENTRIES/PIXB: 


1 


RESERVE ENTRIES/PIXBCBLOCKS): 





FULL ENTRIES/PIXB: 


6 


RESERVE ENTRIES/SIXB: 





FULL ENTRIES/SIXB 


7 


DELETE THRESHOLD ENTRIES: 


7 


FREE POOL SIZE IN BLOCKS: 





# OF INDEX BLOCKS AT LEVEL l: 


9 


# OF INDEX BLOCKS AT LEVEL 2: 


2 


# OF INDEX BLOCKS AT LEVEL 3: 


1 


DATA SET SIZE IN EDX RECORDS: 


72 


INDEXED ACCESS METHOD RETURN CODE: 


-1 


SYSTEM RETURN CODE: 


-1 


ENTER COMMAND (?): 





,-<'■"" ^x 



* _ ^ 



J 
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DI - Display Parameter Values 



DI displays the current parameter values entered via the SE 
command* The parameter values can be used to format a data set 
via the OF command or they can be modified by reusing the SE 
command . 

The following example shoMS a use of the DI command. 



*^ 



ENTER COMMAND (?): DI 

CURRENT VALUES FOR SE 

BASEREC 100 

BLKSIZE 256 

RECSIZE 80 

KEYSIZE 28 

KEYPOS 1 

FREEREC 1 

FREEBLK 10 

R5VBLK NULL 

RSVIX 

FPOOL NULL 

DELTHR NULL 
ENTER COMMAND (?): 



COMMAND ARE: 
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EC - Control Echo Mode 

EC allows you to enter or leave echo mode. When in echo moder 
all $IAMUT1 input and output is logged on the $SYSPRTR device. 
This allows you to save information about the data sets you 
maintain using $IAMUT1. When in echo mode* all input and out- 
put is logged until either the current utility session is ended 
or echo mode is reset by use of the EC command. Echo mode is off 
when $IAMUT1 is loaded. 



c 



Note : Input and output from $DISKUT1 (CR command) is not 
logged . 

The following examples show the commands to set and reset echo 
mode ! 



ENTER COMMAND (?): EC 

DO YOU WANT ECHO MODE? (Y/N) Y 

ENTER COMMAND (?): EC 

DO YOU WANT ECHO MODE? (Y/N) N 

ENTER COMMAND (?) : 



(Set echo mode) 
(Reset echo mode) 
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LO - Load Indexed Data Set 



LO loads an indexed data set from a sequential data set. The 
sequential data set must contain unblocked records. They can 
span two or more 256-byte records. The records in the sequen- 
tial data set must be in ascending order by the data that 
represents the key field. If a record with a duplicate or out of 
sequence key in found» you are given the option to either omit 
the record and continue loading* or to end loading. The indexed 
data set must have been allocated and defined by use of the CR» 
SE and DF commands before using the LO command. 

The record lengths of the two data sets do not have to be the 
same. When the indexed data set is opened, the record length is 
displayed on the terminal. At this point, you can specify the 
record length of the sequential data set if it is different 
than that of the indexed data set. If the indexed data set 
records are longer than the sequential data set records, the 
loaded records are left justified and filled with binary zeros. 
If the indexed data set records sre shorter than the sequential 
data set records, the following message appears on the termi- 
nal : 






INPUT REC GT OUTPUT 
OK TO PROCEED? 



REC, TRUNCATION WILL OCCUR. 



Reply 'Y' to proceed (records will be truncated). Reply 'N' to 
terminate the load function. If the end of the input sequential 
data set is reached, you can continue loading from another 
sequential data set. You are asked if there is more data to 
load. If you reply yes (Y), you are prompted for the data set 
and volume name of the new input sequential data set to use. The 
load operation continues, putting the first record of the new 
input sequential data set in the next available record slot of 
the indexed data set. 

Note s The record lengths of subsequent input data sets are 
assumed to be the same as the initial input data set. 

If the end of input data set is reached and you choose not to 
name another input data set, the load operation is complete. 

The following example shows use of the LO command: 
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ENTER COMMAND (?) : LO 

LOAD ACTIVE 

ENTER INPUT DATASET ( NAME , VOLUME ) : 

ENTER OUTPUT DATASET ( NAME , VOLUME ) : 

INPUT RECORD ASSUMED TO BE 80 BYTES 

LOAD IN PROCESS 

END OF INPUT D/S 

ANY MORE DATA TO BE LOADED?: N 

100 RECORDS LOADED 
LOAD SUCCESSFUL 
ENTER COMMAND (?): 



SEQDATA,EDX002 

SAMPLE1,EDX002 
. OK?: Y 



RO - Reorganize Indexed Data Set 



RO unloads an indexed data set filled by insert activity into 
an empty indexed data set and reorganizes the records to allow 
additional inserts. The empty indexed data set must have been 
allocated and defined by use of the SE» CR» and DF commands 
before using the RO command. 

The record lengths of the two data sets need not be the same. 
Unloaded records are truncated or filled with binary zeros if 
record lengths differ (see LO command). The key fields and key 
positions of the two data sets must be the same; however* the 
other data set specifications (SE parameters) may differ. 






The following example shows use of the RO command: 



ENTER COMMAND (?): RO 

REORG ACTIVE 

ENTER INPUT DATASET ( NAME , VOLUME ) : 

ENTER OUTPUT DATASET ( NAME , VOLUME ) 

REORG IN PROCESS 

END OF INPUT D/S 

100 RECORDS LOADED 
REORG SUCCESSFUL 
ENTER COMMAND (?): 



SAMPLE, EDX002 
SAMPLE1,EDX002 
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RE - Reset Parameters 



RE resets the parameters set up by the SE command to their 
default values . 

The following example shows a use of the RE command? 



ENTER COMMAND (?): RE 
ENTER COMMAND (?): 



t^ 
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SE - Set Parameters 

SE prompts you for parameters that determine the structure and 
size of the indexed data set. The parameter values entered are 
saved by $IAMUT1. This allows you to reuse the SE command to 
change one or more parameters without having to reenter all of 
them. The current values can be displayed by the DI command. 

Note : The values are retained only as long as $IAMUT1 remains 
loaded . 

Size calculations are performed using the parameter values you 
have specified. The results are returned to you at your termi- 
nal. The SE command can be followed by the CR command to create 
a data set of the size specified on the SE command. After the 
data set has been allocated* or if a data set of the correct 
size already exists* the DF command can be used to format it. 

The following list shows the default values for parameters on 
the SE command (all values are decimal): 



BASEREC 





BLKSIZE 





RECSIZE 





KEYSIZE 





KEYPOS 


1 


FREEREC 





FREEBLK 





RSVBLK 


NULL 


RSVIX 





FPOOL 


NULL 


DELTHR 


NULL 



If the default value is acceptable* enter a null line for the 
parameter when prompted for it. If you wish to change the value 
for any parameter* enter the new value in response to the 
prompting message. The new value becomes the new default value 
for the current $IAMUT1 session. The only parameters for which 
a null can be specified are RSVBLK, FPOOL* DELTHR, and RSVIX. 
To specify a null parameter after the original default has been 
modified* enter an ampersand (&) in response to the prompting 
message. For an explanation of the SE command parameters* refer 
to "Determining Data Set Size and Format" on page 2^7. 

The following example shows a use of the SE command in estab- 
lishing the size and structure of an indexed data set. 
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ENTER COMMAND (?) 

ENTER BASEREC 100 

ENTER BLKSIZE 256 

ENTER RECSIZE 80 

ENTER KEYSIZE 28 

ENTER KEYPOS 1 

ENTER FREEREC 1 

ENTER FREEBLK 10 

ENTER RSVBLK 

ENTER RSVIX 

ENTER FPOOL 

ENTER DELTHR 



SE 



After the above information has been entered* the following is 
displayed showing the size and structure of the defined indexed 
data set . 



•X 



TOTAL LOGICAL RECORDS/DATA BLOCK: 

FULL RECORDS/DATA BLOCK: 

INITIAL ALLOCATED DATA BLOCKS: 

INDEX ENTRY SIZE: 

TOTAL ENTRIES/INDEX BLOCK: 

FREE ENTRIES/PIXB: 

RESERVE ENTRIES/PIXBCBLOCKS) : 

FULL ENTRIES/PIXB: 

RESERVE ENTRIES/SIXB: 

FULL ENTRIES/SIXB 

DELETE THRESHOLD ENTRIES: 

FREE POOL SIZE IN BLOCKS: 

# OF INDEX BLOCKS AT LEVEL 1: 

# OF INDEX BLOCKS AT LEVEL 2: 

# OF INDEX BLOCKS AT LEVEL 3: 

DATA SET SIZE IN EDX RECORDS: 
INDEXED ACCESS METHOD RETURN CODE 
SYSTEM RETURN CODE: 
ENTER COMMAND (?): 



3 
2 
50 
32 
7 
1 

6 

7 
7 

9 
2 
1 

72 
-1 
-1 
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UN - Unload Indexed Data Set 



c 



UN unloads an indexed data set to a sequential data set. The 
record lengths of the two data sets need not be the same. 
Unloaded records are truncated or padded with zeros if the 
records lengths of the two data sets differ. Refer to the LO 
command. 

Records are placed in the sequential data set in ascending key 
sequence as indicated by the indexed data set. Unloaded records 
are not blocked. They can span two or more 256 byte records. If 
the indexed data set contains more records tlian are allocated 
in the sequential data set» you are given the option to contin- 
ue unloading to another sequential data set. If you choose to 
continue unloading, you are prompted for the name of the data 
set and volume to use to continue the unload operation. The 
unload operation continues* putting the records read from the 
indexed data set into the new sequential data set. 

Note : The record length of subsequent output sequential data 
sets is assumed to be the same as the initial output sequential 
data set . 



If the end of the output data set is reached and you choose not 
to continue, the unload operation ends. 

Caut 1 on? Do not specify the same data set for input and output. 



r 



The following is an example of the commands and responses of an 

UN command ' 



ENTER COMMAND (?): UN 

UNLOAD ACTIVE 

ENTER INPUT DATASET ( NAME , VOLUME ) : SAMPLEl, EDX002 

ENTER OUTPUT DATASET ( NAME , VOLUME ) : SAMPLE2i EDX002 

OUTPUT RECORD ASSUMED TO BE 80 BYTES. OK?: N 

ENTER RECORD SIZE: 256 

UNLOAD IN PROCESS 

END OF INPUT D/S 

100 RECORDS UNLOADED 
UNLOAD SUCCESSFUL 
ENTER COMMAND (?): 
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Building an Indexed Data Set 



The SE and DF commands allow you to specify the size and format 
of your indexed data set and to do the actual data set format- 
ting. Use the SE command to enter those values that determine 
the size of the indexed data set. Use the DF command to actually 
format the data set using the values previously specified on 
the SE command . 

If the data set is too small to support the specified format* 
the amount of space required is returned to you. Knowing the 
available space and using the SE command* you can vary the SE 
parameters to design a data set of proper size. 



Determining Data Set Size and Format 



The data set design is determined by these SE command parame- 
ters i 



"'N 



BASEREC The estimated number of records to be loaded into the 
data set in ascending key sequence. These records 
can be loaded by $IAMUT1 or by a PUT request after 
either a LOAD or PROCESS request. 



BASEREC should never be zero. 

BLKSIZE The length, in bytes, of blocks in the data set. It 
must be a multiple of 256. 

RECSIZE The length, in bytes, of records in the data set. 
Record length must not exceed block length minus 16. 

KEYSIZE The length (1 to 25^ bytes) of the key to be used for 
this data set . 

KEYPOS The position, in bytes, of the key within the record. 
The first byte of the record is position 1. 

FREEREC The number of free records to be reserved in each 
block. It should be less than the number of records 
per block (block size minus 16, divided by record 
size). It can be zero. 

FREEBLK The percentage (0-99) of each cluster to reserve for 
free blocks. The percentage calculation result is 
rounded up so that at least one free block results. 
The calculation is adjusted to ensure that there is 
at least one allocated block in the cluster? that is. 
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there cannot be 100% free blocks. 



RSVBLK 



The 

i nde 

rese 

as t 

c lus 

so t 

leas 

ad j u 

cate 

(^) 

rese 

meth 

dele 

zero 

rese 

meth 

dele 

prom 

prom 



percentage of the entries in each lowest level 
X block to reserve for cluster expansion. These 
rved entries are used to point to new data blocks 
hey are taken from the free pool to expand the 
ter. The result of the calculation is rounded up 
hat any n on -zero specification indicates at 
t one reserved index entry. The calculation is 
sted to ensure that there is at least one allo- 
d block in the cluster. Enter a null character 
for this prompt if you do not want initial 
rved blocks and do not want the indexed access 
od to create reserved blocks as; records are 
ted and blocks become empty. Specify a value of 
for this prompt if you do not want initial 
rved blocks but you do want the indexed access 
od to create reserved blocks as records are 
ted and blocks become empty (See the DELTHR 
pt). Note that the sum of the FREEBLK and RSVBLK 
pts should be less than 100. 



RSVIX The percentage (0-99) of the entries in each second 
level index block to reserve for use in case of clus- 
ter splits. A cluster split is required when a clus- 
ter expands to its maximum potential size (as 
defined by the RSVBLK prompt) and another data set is 
inserted into the cluster. Each cluster split uses 
one reserved entry of the second level index block. 
The result of this calculation is rounded up so that 
any non-zero specification indicates at least one 
reserved index entry. The calculation is adjusted so 
that there is at least one unreserved entry in each 
second level index block. This value defaults to 
zero . 






FPOOL The percentage (0-100) of the maximum possible free 
pool to allocate. The RSVBLK and RSVIX prompts 
result in a data set structure capable of drawing on 
the free pool for expansion. If insertion activity 
is evenly distributed throughout the data set^ every 
reserve entry of every index block can be used. The 
number of blocks drawn from the free pool to support 
tfn's highly unlikely condition is the maximum free 
pool size needed for the data set. In more realistic 
cases» insertion activity is not evenly distributed 
throughout the data set» so fewer free blocks are 
needed. The percentage specified here represents the 
evenness of the distribution of inserted records. 
Specify a large number (90, for example) if you 
expect insertions to be evenly distributed. Specify 
a small number (20, for example) if insertions are 
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cipated to be concentrated in specific key 

es. If null is specified for this prompt* a free 

is not created for this indexed data set. If 

is specified* an empty free pool is created. 

ks can then be added to the free pool as records 

deleted and blocks become empty (see the DELTHR 

pt explanation). If you do not specify a null for 

prompt* the RSVBLK must not be null and/or the 

X must be non-zero or an error is returned. 

ersely* if the RSVBLK and/or RSVIX is non-zero* 

L must not be null or an error is returned. 



The percentage (0-99) of blocks to retain in the 
cluster as records are deleted and blocks made 
available. This is known as the delete threshold. 
When a block becomes empty, it is first determined if 
the block should be given up to the free pool by 
checking the response to this prompt. If the block is 
not given up to the free pool* it is retained in the 
cluster, either as a free block or as an active empty 
block. The result of this calculation is rounded up 
so that any non-zero specification indicates at 
least one block. The calculation is adjusted to 
ensure that the cluster always contains at least one 
block. If specified as null, this value defaults to 
the number of allocated blocks in the cluster plus 
one half of the value calculated by the FREEBLK 
promr)t. Specify null unless data set usage indicates 
that tuning is required. 



The define (DF) comma r»d sets the size of the data set. There- 
fore* the BASEREC* FREEREC* FREEBLK* RSVBLK* RSVIX* and FPOOL 
parameters should be large enough to accommodate the maximum 
number of records planned for the data set. 

To calculate the size of the data set for a given combination of 
parameters* use the SE command. 
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$IMAGE - DEFINE ^978/4979 FORMATTED SCREEN IMAGE 

$IMAGE defines formatted screen images for the 4978/'^979 dis- 
play terminals* or for any terminal whose support includes the 
static screen functions. The images (formatted screens)* 
which are defined in terms of protected and non-protected 
alphanumeric fields* can be saved in disk or diskette data 
sets* to be retrieved later by application programs for dis- 
play* or by this utility for modification. 

You must allocate the data set where the image will be stored 
before using $IMAGE. Most logical screens require a data set of 
two records. There are two modes of interaction with the $IMAGE 
program: command mode and edit mode. For retrieval informa- 
tion* refer to screen formatting in the System Gu i de . 

You can find an example using $IMAGE to format a static screen 
^' n the System Guide . For an aid in laying out the format of the 
screen to be defined* refer to the IBM 3270 Information Display 
System Layout Sheet* GX27-2951. 



SIMAGE Commands 






$IMAGE is in command mode when loaded. When $IMAGE is in com- 
mand mode* you specify the function to be performed by entering 
an alphabetic code followed by a parameter list. You are 
prompted for each item that is not specified in advance and 
does not have a default value. 

The commands available under $IMAGE are listed below. To dis- 
play this list at your terminal* enter a question mark in 
response to the prompting message COMMAND (?):, 
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COMMANDC?): ? 

DIMS — DEFINE IMAGE DIMENSIONS 

HTAB — DEFINE HORIZONTAL TAB SETTINGS 

VTAB — DEFINE VERTICAL TAB SETTINGS 

NULL — DEFINE NULL REPRESENTATION 

EDIT — ENTER EDIT MODE 

KEYS — LIST PROGRAM FUNCTION KEYS 

SAVE — SAVE IMAGE ON DISK 

END -— END PROGRAM 

COMMANDC?) : 



After the commands are displayed* you are again prompted with 
COMMAND (?):, You respond with the command of your choice (for 
example , DIMS) . 



^\ 



DIMS - Define Image Dimensions 

The DIMS command is followed by two values* giving the number 
of lines and the line size* for example: 



DIMS 10 20 
DIMS 2^ 80 



(10 20-character lines) 
(full screen image) 



EDIT - Enter Edit Mode 

The EDIT command can be followed by a data set name in the form.* 



dataset » volume 



Here the volume* if unspecified* defaults to the IPL volume. 
If a data set name is not given* then the program displays the 
currently defined image. Some examples are: 
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EDIT 

EDIT IMAGEl 

EDIT IMAGES, EDX002 



END - End the Program 

END (or EN) ends the utility program. If the screen image has 
been modified since the last SAVE operation* then the questions 



SAVE FINAL IMAGE? 



appears. The image is saved or not» depending on your response 
(YES/NO)» and the command prompting message is issued again. 



HTAB - Define Horizontal Tab Settings 

HTAB defines tab settings for the duration of edit mode» for 
examp le : 







The default settings are 10, 20, 30, 40, 50, 60 and 70. If a tab 
value exceeds the line size or is not in ascending order, then 
the cursor moves to the next line when that setting is encount- 
ered. Nhen the horizontal tab key (PFl when in EDIT mode) is 
pressed, the cursor moves to the next horizontal tab position. 



^^a^ 
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KEYS - List Program Function Keys 

KEYS lists on the terminal the meaning of the PF keys while in 
the edit mode. 



COMMANDC?): KEYS 

PFl -- DEFINE PROTECTED FIELDS 
PF2 — DEFINE DATA FIELDS 
PF3 — ENTER COMMAND MODE 

COMMANDC ?) : 



PFl and PF2 function as the horizontal and vertical tab keys 
(respectively) when you are defining protected or data fields 
in EDIT mode . 



NULL - Define Null Representation 

NULL defines a character that is interpreted as the null char- 
acter during editing of the image. Null characters define the 
non-protected positions on the screen image to be used for data 
entry. Some examples are: 



NULL . 
NULL / 
NULL 

CHARACTER: 



In the last example, no character was indicated causing the 
prompt message to be issued. If again no character is entered, 
then the null character itself is used. 

Note t If the NULL command is not defined prior to an editing 
session, the null character defaults to a period (.). There- 
fore, all periods defined as protected in subsequently edited 
screens assume an unprotected status. 
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SAVE - Save Image on Disk 

The screen image* as currently defined* is saved in the last 
data set edited* or in a new data set if one is specified 
following SAVE. The formatting information and text that 
define the image are stored in the specified data set in a spe- 
cial packed format to conserve space. For packed format infor- 
mation* refer to the System Gu i de . Some examples are? 



SAVE 

SAVE IMAGE2 

SAVE IMAGE2,EDX003 



When the image has been saved* the following message appears* 
with the number of 256 byte records indicated in parentheses. 



SAVED n(RECORDS) 



%J 



VTAB - Define Vertical Tab Settings 

VTAB defines vertical tab settings to conveniently edit the 
screen image by columns rather than rows. The default vertical 
tabs range from 1 to 24 in 1-line increments. These can be rede- 
fined as in the following examples 




When the vertical tab key (PF2 when in edit mode) is pressed* 
the cursor moves to the next indicated line at the last 
encountered horizontal tab setting. When the last vertical tab 
setting is passed* the cursor moves to line at the next hori- 
zontal tab setting. 
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Edit Mode 



When you enter edit mode* the current image is displayed within 
a rectangular frame whose upper lefthand corner is at line 0> 
indent 0. The frame and all screen positions outside it are 
protected in the display buffer; this limits the cursor to 
positions within the frame when the field-advance key is 
pressed. If the image dimensions do not allow display of the 
entire frame* then its sides are omitted according to the fol- 
lowing priority! top before bottom* left before right. 

Null characters* dimension fields* and tab settings should be 
defined before entering edit mode. If you are modifying an 
existing screen image* the null character must be redefined 
each time $IMAGE is invoked. 

Once the image is displayed* you can invoke the edit phases by 
means of the PF keys. 

PFl This key causes the protected fields of the image to be 
displayed as non-protected* so you can redefine them 
directly on the screen. The non-protected (data) fields 
of the image are indicated with the null representation 
character* and you use that character to redefine those 
fields if desired. Once this edit phase has been entered* 
PFl acts as the horizontal tab key and PF2 as the verti- 
cal. Nhen the ENTER key is pressed* the newly defined 
image is displayed* with protected fields in their proper 
mode . 

PF2 This key prepares the $IMAGE program for modification of 
the data (non-protected) fields of the image. The cursor 
is displayed at position (0,0) of the image, and you can 
use the field-advance keys to move to each data field in 
turn, or the tab keys (PFl and PF2) can be used when appro- 
priate. When the ENTER key is pressed* the new data val- 
ues are saved* but not yet written to disk. 

PF3 This key is used to return from edit mode to command mode. 



Note : The ENTER key 
function correctly. 



must have been used for PF3 to 
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SINITDSK 

$INITDSK - INITIALIZE OR VERIFY VOLUME 

$INITDSK initializes and/or read verifies a Series/1 direct 
access storage device volume for use with the Event Driven 
ExGcut i ve , 

$INITDSK performs the following functionsJ 

• In i t i a 1 i zat ion ( I ) 

Initializes a library directory for the Event 
Dr i ven Execut i ve 

Writes IPL text on a disk or diskette* if desired. The 
IPL device address for 4962 disk, 4963 disk, 4964 
diskette, and 4966 diskette magazine units are 
hexadecimal 03, 48, 02, and 22, respectively. An ini- 
tialized diskette can be used to IPL from either a 4964 
or 4966 diskette device. 

- Writes a volume label on a diskette. 

Note J A label is not required on a disk since it is not 
a removable device. 

• Verification (V) verifies the readability of? 

- A group of records within a disk or diskette volume 

- A disk or diskette volume 

- All disk volumes at a specified address 

• Writes (W) only IPL text on a primary volume for which 
$EDXNUC has been allocated. 



'kJ 



$INITDSK Commands 



The commands available under $INITD5K are listed below. To dis- 
play this list at your terminal, enter a question mark in 
response to the prompting message COMMAND (?)? 
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COMMAND (?): ? 

E - END PROGRAM 
I - INITIALIZE DISK(ETTE) 
V - VERIFY DISK(ETTE) AREA 
W - WRITE IPL TEXT ONLY 

COMMAND (?): 






After the commands are displayed^ you are again prompted with 
COMMAND (?):. You respond with the command of your choice (for 
example > I ) . 



Initialization 



Directory Creation 



A directory can be created on each volume with $INITDSK. The 
minimum directory size is 2 records. The maximum sizes are 120 
records on a ^962> ^963> ^96^» or A966 and 60 records on the 
fixed head volume of a ^962 or ^963. The maximum volume size» 
including directory, is 32,767 records. The directory size 
determines the maximum number of programs and data sets that 
can be stored, A directory of n records can catalog a maximum 
of 8n-2 data sets. 



Diskette Ini t i a 1 i z a t i o n 



The volume label 
EBCDIC Basic Exc 
is written which 
data set . An ent 
Execut i ve volume 
contain up to a 1 
A double-sided d 
record directory 
have been pre v i o 
using the $DASDI 



on a diskette conforms to the standard for an 
hange format. One EBCDIC Header Label (HDRl) 

describes the entire diskette as an allocated 

ire diskette is considered as an Event Driven 

A single-sided diskette is initialized to 

3-record directory and a 949-record data area. 

iskette is initialized to contain up to a 26 

and an 1898 record data area. A diskette must 
usly initialized to 128 bytes per sector by 
utility. On a ^966 diskette magazine unit, you 
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$IF.IITDSK 



can initialize only on slot number 1 



Disk Initialization 



Each disk volume (primary and secondary) must be initialized by 
using $INITDSK. 

Cau ti ons If you initialize and create a directory on disk or 
diskette, any data previously stored on the disk or diskette 
Mill no longer be accessible. 



\y 
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Example 

Init i alizing and Mriting IPL Text on Diskette 






$INITDSK 13P, 13.<^<^. 14, LP= 5000 

COMMAND (?): I 

LIBRARY INITIALIZATION 

1 = ENTER VOLUME LABEL 

2 = ENTER DEVICE ADDRESS 
SELECT OPTION: 2 

ENTER DEVICE ADDRESS IN HEX: 2 

WRITE VOLUME LABEL? Y 

ENTER DESIRED VOLUME LABEL Cl-6 CHARACTERS) EDXOOl 

ENTER ONNER ID (1-14) CHARACTERS: DEPT.L78 09/77 

LABEL WRITTEN 

CREATE A DIRECTORY? Y 

HOW MANY RECORDS IN DIRECTORY? (2 - 120): 13 

MAXIMUM NO. OF MEMBERS = 102, OK? Y 
DO YOU WISH TO RESERVE SPACE FOR A NUCLEUS? Y 
ENTER MAXIMUM SIZE IN K-BYTES (16-64): 32 
DIRECTORY INITIALIZED 
WRITE IPL TEXT? Y 
IPL TEXT WRITTEN 

COMMAND (?): EN 

$INITDSK ENDED AT 13:54:00 
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Verif 1 cation 



$INITDSK can be used to perform a readability check of an 
entire disk device* or an entire disk or diskette volume* or 
any portion thereof* to determine if any defective records 
exist for which alternates should be assigned. Only record 
read operations are performed. Therefore* a verify operation 
can be performed with no risk of destroying existing data. 

Examples 

Verifying Portion of a Volume 



COMMANDC?): V 

DISK OR DISKETTE VERIFICATION 

1 = ENTER VOLUME LABEL 

2 = ENTER DEVICE ADDRESS 
SELECT OPTION: 1 

ENTER VOLUME LABEL: EDX002 

EDX002 AT 0003 IS A PRIMARY DISK 
CHECK THE ENTIRE VOLUME? NO 
FIRST RECORD = 300 
NO. OF RECORDS = 1200 
1200 RECORDS CHECKED 

COMMAND (?): 
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I Verifying All Volumes on a Disk 






COMMANDC?): V 

DISK OR DISKETTE VERIFICATION 

1 = ENTER VOLUME LABEL 

2 = ENTER DEVICE ADDRESS 
SELECT option: 2 

ENTER DEVICE ADDRESS IN HEX: 3 



CHECK THE ENTIRE VOLUME? Y 
ASSIGNED ALTERNATE SECTOR AT 
ASSIGNED ALTERNATE SECTOR AT 
ASSIGNED ALTERNATE SECTOR AT 
EDX002 32000 RECORDS CHECKED 
EDX003 30000 RECORDS CHECKED 
EDXOO^ 12000 RECORDS CHECKED 

COMMAND (?): 



RECORD 
RECORD 
RECORD 



121 
122 
151 



Verifying Diskette Volume (No Errors Found) 



COMMAND (?): V 

DISK OR DISKETTE VERIFICATION 

1 = ENTER VOLUME LABEL 
•2 = ENTER DEVICE ADDRESS 
SELECT option: 2 

ENTER DEVICE ADDRESS IN HEX: 2 

CHECK THE ENTIRE VOLUME? YES 
962 RECORDS CHECKED 

COMMAND (?): 
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Write IPL Text Mhere $EDXNUC Has Been Preal located 



COMMAND (?): M 

WRITE IPL TEXT 

1=ENTER VOLUME LABEL 

2=ENTER DEVICE ADDRESS 
SELECT option: 1 

ENTER VOLUME LABEL: EDX002 

EDX002 AT 0002 IS A PRIMARY DISKETTE 

WRITE IPL TEXT? Y 
IPL TEXT WRITTEN 

COMMAND (?): 



Write IPL Text on a Volume That Does No t Contain $EDXNUC 



COMMAND (?): M 

WRITE IPL TEXT 

1=ENTER VOLUME LABEL 

2=ENTER DEVICE ADDRESS 
SELECT option: 1 

ENTER VOLUME LABEL: EDX002 

EDX002 AT 0002 IS A PRIMARY DISKETTE 

IPL WRITE ABORTED. NO NUCLEUS FOUND 

COMMAND (?): 
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SIOTEST - TEST SENSOR I/OJ LIST CONFIGURATION 



$IOTEST determines the complete I/O configuration of a 
Series/1 and tests the operation of sensor based I/O features. 
$IGTEST performs the following functions: 

Reads and writes digital (group or subgroup) 

Hrites digital with selected time intervals 

External sync DI and DO 

Processes interrupts (normals special bit and group) 

Reads and writes analog 

Lists the hardware configuration of the Series/l 

Lists the devices supported by the system 

Lists volume information 



.^ 



Invoking SIOTEST 



$IOTEST can be invoked by the session manager using the Diai 
nostic Utilities option menu or by the $L command. 
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SIOTEST Commands 



o 



The commands available under $IOTEST are listed below. To dis- 
play this list at your terminal, enter a question mark 
response to the prompting message COMMAND (?):. 



1 n 



$IOTEST 24P, 13:26:42 LP=5000 

ATTNLIST (ALTER) TO STOP LOOPING FUNCTIONS 

COMMAND (?): ? 



TIME 



EN = END PROGRAM 

DO = DIGITAL OUTPUT 

PD = UP AND DOWN DO WITH 

XO = EXTERNAL SYNC DO 

DI = DIGITAL INPUT 

XI = EXTERNAL SYNC DI 

PI = PROCESS INTERRUPT 

SG = SPECIAL PROCESS INTERRUPT GROUP 

SB = SPECIAL PROCESS INTERRUPT BIT 

AI = ANALOG INPUT 

AO = ANALOG OUTPUT 

LD = LIST ALL HARDWARE DEVICES 

LS = LIST SUPERVISOR CONFIGURATION 

VI = DISPLAY VOLUME INFORMATION 

WS = PUT PGM IN WAIT STATE 

COMMAND (?): EN 

$IOTEST ENDED AT 13:27:29 



/1'^"^\ 

vy 



After the commands are displayed, you are again prompted with 
COMMAND (?):. You respond with the command of your choice (for 
example , DO) . 

AI and DI issue a read every 10 milliseconds and only prints the 
value if it is different from the last reading. PI issues a wait 
and prints on each occurrence. External sync DI and DO perform 
their functions and do not return to command status until the 
number of words indicated are read or written. ALTER is used to 
terminate repetitive functions and to reactivate the program 
if it was put in the wait state. 
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Examples 

DO - Nrite X'A5A5' to DO Address 52 



COMMAND (?) : DO 

ENTER DEVICE ADDRESS ,(HEX 1-FF) 

ENTER START BIT (0-15) : 

ENTER # OF BITS : 16 

ENTER DATA (HEX) : A5A5 

COMMAND (?): 



: 52 



PD - Pulse DO Address 53 Bit 8 on for 10 Milliseconds^ Off for 
50 Milliseconds 100 times 



COMMAND (?): 
ENTER DEVICE 



PD 

ADDRESS 



(HEX 1-FF) 



ENTER START BIT (0-15) : 

ENTER # OF BITS : 1 

ENTER DATAl (0-FFFF) : 1 

ENTER TIMEl IN MS J 10 

ENTER DATA2 (0-FFFF) : 

ENTER TIME2 IN MS : 50 

ENTER NUMBER OF TIMES TO 
COMMAND (?): 



8 



53 



LOOP 



100 



Note : If number of times to loop is set less than or equal to 
zero» the looping continues until the next ALTER command. 
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XO - Nrite Digital Output using External Svnc 



COMMAND (?): XO 

ENTER DEVICE ADDRESS ,CHEX 1-FF) 
ENTER WORD COUNT 1-256 : 100 
COMMAND (?): 



: 53 



Note : Data is Nritten from a buffer within this program that is 
used for external sync DI an DO. Therefore* data can be input 
via DI and written via DO. 

DI •- Read Digital Input 



COMMAND (?): DI 

ENTER DEVICE ADDRESS ,(HEX l-FF) 

START BIT (0-15) : 

# OF BITS : 16 

= A5A5 

= COFE 



: 50 



ENTER 
ENTER 
VALUE = 
VALUE = 
> ALTER 
COMMAND 



(?) 



XI - Read Digital Input using External Svnc 



COMMAND (?): XI 

ENTER DEVICE ADDRESS ,(HEX 1-FF) 

ENTER WORD COUNT ; 100 

COMMAND (?): 



I 51 
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PI - Test Process Interrupt for the Occurrence of this Event 



COMMAND (?): 
ENTER DEVICE 
ENTER BIT (0 
PI OCCURRED 
PI OCCURRED 
PI OCCURRED 
> ALTER 
COMMAND (?): 



PI 

ADDRESS 
15) : 3 



(HEX 1-FF) : 50 



SG/SB - Special Process Interrupt Group/Bit 



Commands SG and SB functionally operate differently within the 
supervisor but they print basically the same information as 
normal PI with this utility program. 



y 



An easy way to test the system is to use the Customer Engineer's 
wrap back connectors. The wrap cable for the IDIO unit con- 
nects the first DI address on the card to the first DO address 
and the same for the second DI and DO. These connections 
include the external sync functions also. Therefore, two 
copies of $IOTEST can be executed simultaneously. There are 
similar connectors available for the <^982 Sensor I/O Unit. 
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AI - Read Analog Input 



COMMAND (?): 


AI 












ENTER DEVICE 


ADDRESS 


,(HEX 1- 


■FF) : 61 






ENTER RANGE: 


1 = 


5V, 2- 


=500MV, 3=200MV, 


A = 


lOOMV, 




5 = 


50MV, 


6=20MV, 


7=10MV ; 


7 




ZERO CORRECTION 


? N 










ENTER MPXR POINT (0- 


15) : 1 








AI VOLTAGE = 




-629 


MV, E-3 








AI VOLTAGE = 




-688 


MV, E-3 








> ALTER 














COMMAND (?): 















Analog input has a testing facility to convert diagnostic zero 
or voltage. This utility allows these functions if the ADC 
address is given instead of the multiplexor address. 



COMMAND (?): AI 

ENTER DEVICE ADDRESS ,(HEX 1-FF) : 60 

CONVERT DIAGNOSTIC ZERO ? Y 

ENTER RANGE: 1 = 5V, 2 = 500MV, 3 = 200MV, '^ = 100MV, 

5=50MV, 6=20MV, 7=10MV : 1 
AI VOLTAGE = MV, E-0 
> ALTER 



COMMAND (?): AI 

ENTER/DEVICE ADDRESS ,(HEX 1-FF) 

CONVERT DIAGNOSTIC ZERO ? N 



60 



CONVERTING DIAGNOSTIC VOLTAGE, SHOULD BE 4.5 +■ 
AI VOLTAGE = 4604 MV, E-0 
AI VOLTAGE = 4602 MV, E-0 
> ALTER 
COMMAND C?): 



0.5 






J 
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COMMAND (?): AI 

ENTER DEVICE ADDRESS ,(HEX 1 

CONVERT DIAGNOSTIC ZERO ? N 



FF) 



60 



CONVERTING DIAGNOSTIC VOLTAGE, SHOULD BE A. 5 +- 
AI VOLTAGE = ^60^ MV, E-0 
AI VOLTAGE = 4602 MV, E-0 
> ALTER 
COMMAND (?): 



LD - List Devi ces 



LD reads the actual hardware addresses, their IDs, and displays 
a list of the descriptions. If a device exists but isnot pow- 
ered on, the description for that device is displayed. 



COMMAND (?): LD 

ACTUAL SERIES/1 HARDWARE CONFIGURATION 

00 = TELETYPEWRITER ADAPTER 

01 = 4974 PRINTER 

02 = 4964 DISKETTE UNIT 
04 = 4979 DISPLAY STATION 
09 = SINGLE LINE BSC 

40 = TIMER FEATURE 

41 = TIMER FEATURE 

50 = IDIO DI/PI NON-ISOLATED 

51 = IDIO DI/PI NON-ISOLATED 

52 = IDIO DO WITH EXTERNAL SYNC 

53 = IDIO DO WITH EXTERNAL SYNC 

COMMAND (?): 
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LS -- List Supervisor Configuration 






LS provides a display similar to LD except that it lists the 
devices your supervisor is generated to support (Nhether or not 
they are in the hardware of the system currently being used). 



VI - Display Volume Information 



VI displays information about volumes as follows 



COMMAND (?) 


: VI 












VOLSER 


TYPE 


lODA 




STATUS 


VOLORG 


VOLSIZE 


LIBORG 


NRQ021 


PRI. 


0002 




ONLINE 





75 


27 


NRPOOl 


PRI. 


0022 


1 


ONLINE 





75 


27 


SMVOL 


SEC. 


0022 


2 


OFFLINE 





75 


27 


NRP002 


SEC. 


0022 


3 


ONLINE 


13 


74 


14 


NRP003 


SEC. 


0022 


lA 


ONLINE 


13 


75 


27 


NEWPRG 


SEC. 


0022 


3A 


ONLINE 





74 


14 


FORT 


SEC. 


0022 


4A 


ONLINE 


13 


75 


27 


DEV 


SEC. 


0022 


lOA 


ONLINE 





74 


14 


EDX002 


PRI. 


0003 




ONLINE (IPL) 





130 


241 


ASMLIB 


SEC. 


0003 






130 


16 


1 


SUPLIB 


SEC. 


0003 






146 


16 


1 


EDX003 


SEC. 


0003 






162 


141 


1 


EDX005 


PRI. 


00^8 




ONLINE 





50 


705 


EDX006 


SEC. 


0048 






51 


50 


1 


EDX007 


SEC. 


00<^8 






150 


50 


1 


EDX008 


SEC. 


00*^8 






200 


50 


1 






( 



y 
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$JOBUTIL - JOB STREAM PROCESSOR 



$JOBUTIL is a batch job processing capability that can be 
invoked simultaneously with the execution of other programs. 
This allows you to sequentially execute a series of programs 
without intervention. You include the names of the programs* 
and other information in a collection of $JOBUTIL commands cre- 
ated via $EDIT1N or $FSEDIT. 

A procedure can invoke another procedure* however* the called 
procedure cannot invoke another. A typical use of $JOBUTIL 
would be to execute a procedure that causes the assembly* link 
editing* and formatting of your program. Refer to "Batch Job 
Example" on page 290. 

$JOBUTIL is the main program that calls two overlay programs: 
$JP1 which opens required data sets and $JP2 which processes 
all commands . 

Programs that are capable of receiving parameters in the format 
used by $JOBUTIL are: 



N 



^ 



$COBOL 
$EDXASM 
$FORT 
$LINK 



$PL/I 
$PREFIND 
$S1ASM 
$UPDATE 



Setup Procedure 



The steps required to set up and start a procedure are? 

1. Using $DISKUT1* allocate a data set on either disk or 
diskette which is to contain the procedure. The size of 
the data set depends on the number of commands. Allocate 
one record for each two commands. 

2. Using $EDIT1N or $FSEDIT* enter the $JOBUTIL commands nec- 
essary for your procedure into an editor work data set* and 
'SAVE' them in the data set allocated in Step 1. 

3. To run your job, load $JOBUTIL and specify the name of your 
procedure data set. Loading can be done by use of the ses-^ 
sion manager or the $L command. 
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$JOBUTXL Commands 



The $JOBUTIL commands are listed below. Commands must be 
entered in the following format: 

Command - Position 1 to 8 

Operands - Position 10 to 17 

Comment - Position 18 to 71 

For internal comments - * ^ * in position 1 

Note : All commands without operands can have comments starting 
i n pos i t i on 10 . 



Command 



Funct i on 



AL Allocate data set 

DE Delete data set 

DS Identify data set 

EOJ Identify end of job 

EOP Identify end of nested procedure 

EXEC Load and execute program 

JOB Identify job 

JUMP Jump to label 

LABEL End jump 

LOG Log Job Stream Processor Commands 

NOMSG Suppress load messages 

FARM Identify program parameter 

PAUSE Await manual intervention 

PROC Identify nested procedure 

PROGRAM Identify program 

REMARK Remark to operator 

^ Internal comment 



^ 
% 



^Hii^ 
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AL - Allocate Data Set 

AL identifies a data set to be allocated. It returns a $DISKUT3 
return code that can be used by the JUMP command. 



Syntax 



AL name^volume size type 

Required: name»volume 

s i ze 

type 
Default: None 



Operands 






name 



volume 



s 1 ze 



type 



Example 



Descr i pt i on 

Defines the data set to be allocated 

Defines the volume on which the data set is to be 
a 1 located 

Defines the size in blocks of the data set 

Defines the type of data set as follows: 

D indicates data (default) 

P indicates program 

U indicates undefined 
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DE " Delete Data Set 

DE identifies a data set to be deleted 

Syntax 



^1 



DE 



name t volume 



Required* name^volume 
Default: None 



Operands 

name 

volume 

Example 



Descr i pt i on 

Defines the data set to be deleted 

Defines the volume from which the data set is to be 
deleted 
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DS - Identify Data Set 

DS identifies a data set to be opened and accessed by a program 
DS commands are allowed only between PROGRAM and EXEC commands 
Up to nine (9) DS commands can be specified for a program. 

Syntax 



DS name t volume 

Requ i red : name 

Default: volume is IPL volume 






Operands 

name 

volume 

Example 



Descr i pt i on 

Defines the data set to be accessed by a program 

Defines the volume that contains the data set to be 
accessed by a program 



DS 



WORK1,EDX001 
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EOJ - End of Job 



O' 



EOJ indicates the end of the primary procedure and must be the 
last command in the procedure data set. data set. 

Syntax 




No operands are required. 



EOP - End of Procedure 



EOP indicates the end of a nested procedure and must be the last 
command in the called procedure data set. 

Syntax 




V-.y 



No operands are required. 
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EXEC ~ Execute Program 



$JOBUTIL 



EXEC loads and executes the program identified in the preceding 
PROGRAM command. EXEC must have been proceeded by a PROGRAM 
command. 

Syntax 



EXEC 

Requi red : 
Default : 



STORAGE = si ze 

None 

STORAGE=0 



Operands 
STORAGE 



Descr i pt i on 

Specifies the amount of dynamic storage to be allo- 
cated to the program to be executed. This value 
overrides the value specified when the program was 
compiled. STORAGE=0 (the default) indicates that 
the dynamic storage specified (if any) during com- 
pilation should be allocated. 
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JOB - Identify Job 

JOB> an optional command* identifies the procedure or a col- 
lection of commands within a procedure data set. When a JOB 
command is read by $JOBUTIL» a message is printed on the termi- 
nal with the Job name» time started and date (if timer support 
is i nc luded ) . 

Syntax 



o 



JOB job-name 
Required? job-name 



Operands Descr i pt i on 

job-name Names the current group of commands as a job 

Example 



V 
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JUMP - Jump to Label 

JUMP bypasses $JOBUTIL commands by testing the completion code 
of the previously executed program. The test compares the pro- 
gram completion code to "cc". The commands between the JUMP and 
the LABEL command with the same label name are ignored if the 
condition tested for is *true*. An unconditional JUMP to a 
LABEL is also permitted. Jumps are forward only and are limited 
to the range of the current procedure* for example* a jump can- 
not occur from one procedure to a label in another procedure. A 
JUMP with no label name jumps to the next unlabeled LABEL com- 
mand or to an EOJ or an EOP» whichever occurs first. If an EOJ 
or an EOP is encountered while searching for a LABEL command, 
the search for the LABEL command terminates and the EOJ or EOP 
i 5 executed . 



Note : The JUMP and LABEL commands 
PAUSE mode. 



are not permitted in the 



Syntax 



JUMP label-name , op , cc 
Requ i red * None 



Operands Descr i pt i on 

label-name The name associated with a LABEL command 

op LT, GT, EQ, GE, LE, or NE . 

cc Program completion code. 

Examples 
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LABEL - Identify Continuation Point 

Job processiing continues at the LABEL command after a related 
JUMP command is encountered. The LABEL command is not valid in 
the PAUSE mode . 

Syntax 



LABEL label-name 
Required: None 



Operands Description 

label-name Defines the command where processing can continue 

Examples 



LABEL 
LABEL 



LBLl 



"i^-y 
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LOG - Log Control 

LOG indicates whether the $JOBUTIL commands are to be printed 
as they are read and which terminal device is to print them. 
LOG commands can be placed anywhere in the procedure data set. 
If a terminal device is not specified? the commands are logged 
on the terminal from which the Job Processor was invoked. 

Syntax 



LOG 

Requ i red : 
Default : 



Operand 

None 
ON 






Operands Desc r i pt i on 

ON Indicates that $JOBUTIL commands are to be printed 

OFF Indicates that $JOBUTIL commands are not to be 
pr i nted 



termi nal~name 



Examples 



Identifies the terminal device which is to print 
the job processor commands. If omitted indicates 
that the job processor commands are to be logged on 
the terminal from which the job processor was 
called. 



LOG 
LOG 
LOG 
LOG 



ON 

OFF 

$SYSPRTR 
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NOMSG - No Message Logging 

NOIiSG sets LOGMSG = NO for the program identified in the preced- 
ing PROGRAM command. See the LOAD instruction in the Lang uage 
Reference for the definition of LOGMSG. NOMSG is invalid if not 
preceded by a PROGRAM command. 

The NOMSG command must be between the PROGRAM and EXEC com- 
mands * 

Syntax 






NOMSG 

Requ i red : None 



No operands are required 
Example 



PROGRAM 
NOMSG 



CALCDEMO 
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FARM ~ Pass Parameter 

PARM identifies the parameters to be passed to the program in 
the preceding PROGRAM command. PARM must be between the PRO- 
GRAM and EXEC commands. Maximum length of the operand on the 
PARM command is 62 bytes. The parameters specified on the PARM 
command are passed to the specified program as an EBCDIC char- 
acter string. In the specified program they can be referenced 
as beginning at the label $PARM1 and are packed two characters 
per word. The length of the string is determined by the 
*PARM=n' operand of the PROGRAM statement in the specified pro- 
gram. For example, 'PARM=31* would cause the maximum 62 char- 
acters from positions 10-71 of the PARM command to be 
transferred to the specified program starting at the label 
$PARM1. 



Syntax 



PARM parameters 
Required: None 



Operands Descr i pt i on 

parameters Defines parameters to be passed to the program 

Example 



PARM 



NOLIST,XREF 



Chapter 4. The Utilities 



283 



$JOBUTIL 



PAUSE - AMoiit Manual Intervention 

PAUSE allows $JOBUTIL commands to be entered from a terminal 
keyboard. JUMP and LABEL commands are not permitted. 

When a PAUSE command is read* you are prompted for input. You 
communicate with the processor using the attention key and 
three PAUSE subcommands. 

You can initiate the PAUSE mode by pressing the attention key 
and typ i ng PAUSE , 

PAUSE subcommands srei 

• ABORT - To end $JOBUTIL processing 

• ENTER - To enter $JOBUTIL commands 

• GO - To end the PAUSE mode and read the next command in the 
procedure data set 

Syntax 



c 



PAUSE 

Requ i red : None 



V 



No operands are required. 
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Example 

Data Set with PAUSE 



JOB 


PAYROLL 


LOG 


ON 


PROGRAM 


NAGES 


EXEC 




REMARK 


LAST DAY OF MONTH? 


REMARK 


RUN MONTHEND 


PAUSE 




EOJ 





In PAUSE Mode (Terminal Output) 



^*"\ 



ATTN: GO/ENTER/ABORT 



PAUSE - * 

PAUSE 
>ENTER 



ENTER COMMAND PROGRAM 

ENTER OPERAND MONTHEND 

ENTER COMMAND EXEC 

ENTER OPERAND 
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PROC - Execute Procedure 



"lr\ 



PROC allows you to pass control to another procedure data set. 
The operand identifies the data set. A PROC command is not 
allowed in the called procedure data set. PROC cannot be 
placed between a PROGRAM command and EXEC command. The com- 
pletion code of the last program executed in the sub-procedure 
will be available for testing by the main procedure. 

Syntax 



PROC 



procedure -name, volume 



Required: procedure-name 
Default: volume is IPL volume 



Operands Descr i pt i on 
procedure-name 



.r--^ 



Defines the procedure data set to which control is 
to be passed . 



*4nj_ 



y 



volume Defines the volume containing the procedure data 
set to which control is to be passed. 

Examples 



PROC 
PROC 



PAYROLL, EDX002 
PAYROLL 
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PROGRAM - Identify Program 

PROGRAM identifies a program to be executed 

Syntax 



PROGRAM program-name » volume 

Required? program-name 
Default: volume is IPL volume 



m^ 



Operands Descr i ot i on 
program-name 



volume 



Examples 



Defines the name of the program member to be 
executed 

Defines the name of the volume containing the 
program member to be executed 



PROGRAM $DEBUG,EDX002 
PROGRAM CHECKS 
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REMARK ~ Display Remark 

REMARK allows you to output a message to the operator with log 
ON or OFF. The operand contains the message. The maximum mes- 
sage length is 62 bytes. 

Syntax 



REMARK comment 
Required: None 



Operands Descr i pt i on 

comment Defines the comment to be displayed 

Example 



REMARK 



INSERT DISKETTE EDX005 



-vV 
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^ - Comment 

An asterisk (^) in position 1 allows internal comments in the 
procedure data set. Comments can start in position 2. The 
internal comment is not printed. 

Syntax 



^ internal comment 
Requ 1 r ed : None 






No operands are required. 
Example 
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Batch Job Example 



The following examples list three procedure data 
last two procedures shown are invoked by the first. 



sets 



The 



List Data Set BATCH on EDX003 



JOB 

LOG 

REMAR 

PROGR 

NOMSG 

DS 

FARM 

EXEC 

PROGR 

EXEC 

JUMP 

PROGR 

EXEC 

LABEL 

PROGR 

PARM 

EXEC 

JUMP 

PROGR 

DS 

EXEC 

LABEL 

PROC 

PROC 

EOJ 



BATCH 

$SYSPRTR 
K THIS JOB SHOULD RUN UNINTERRUPTED 
AM JUTEST1,EDX003 

LOAD1,EDX003 
F0F4F1F7 

AM JUTEST2,EDX003 

JMP1,EQ,-10 
AM CALCDEMO,EDX002 

JMPl 
AM JUTEST3,EDX003 
2 

JMP2,LT,5 
AM $EDIT1N,EDX002 
EDITWORK,EDX002 

JMP2 

PROC1,EDX003 

PROC2,EDX003 



^' 



v„-V 
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List Data Set PROCl on EDX0Q3 



LOG 

REMARK 

PROGRAM 

EXEC 

EOF 



ON 

PROCl 

JUTEST2,EDX003 



List Data Set PR0C2 on EDX003 



REMARK 

PROGRAM 

DS 

PARM 

EXEC 

EOP 



PR0C2 

JUTEST1,EDX003 
LOAD1,EDX003 
ENDT 



'"■^^^ 
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$LOG - LOG I/O ERRORS INTO DATA SET 



$LOG records information concerning I/O errors onto a disk or 
diskette data set. The information recorded on the log data set 
can then be displayed using $DISKUT2. 

Note » You must include the supervisor I/O error logging module 
(SYSLOG) in your generated system to have I/O error logging 
capab i 1 i ty . 



L09 Data Set 



Before I/O errors can be recorded* you must allocate a log data 
set to contain the device and system information available at 
the time of the I/O error. The log data set should be at least 
eight records long and should be named $LOGDS. $LOGDS may 
reside in a disk or diskette volume. The log data set contains 
one 256-byte log entry per record. The first two records are 
used for control information. 



If the log data set was previously used and contains valid 
entries* new entries sre added after the old ones. If the data 
set is not initialized* a new log control record is written* 
indicating that no entries are in the log data set. When the 
log data set becomes full* the following message is sent to the 
termi nal : 



J 



$LOG - ^^^ INSUFFICIENT BUFFERS FOR LOG RATE ^^* 



Following this message* subsequent log entries 
written over the oldest entries. 



received are 



Invoking $LOG 



To activate error logging, load $LOG into any partition. Use 
the session manager diagnostic utilities option menu or the $L 
operator command. You are prompted for the name of the log data 
set. After $LOG is loaded and error logging is activated* you 
can use attention commands provided by $LOG to deactivate, 
reactivate or terminate error logging. You can also reinitial- 
ize the log data set using one of these attention commands. For 
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information about I/O error logging* system generation consid- 
erations* and execution time interfaces* refer to the System 
Guide , 

Example: The following example shows how to activate error log- 
ging and the attention commands that are available. 



o 



> $L $LOG $LOGDS,EDX002 
$LOG 21P, LP= 7400 



$ L G 



UTILITY 



THE FOLLOWING ATTENTION COMMANDS ARE AVAILABLE 



ATTN/$LOGOFF 

ATTN/$LOGON 

ATTN/$LOGINIT 

ATTN/$LOGTERM 

ATTN/$LOG 

WARNING: DO NOT 



TEMPORARILY DEACTIVATE LOGGING 
REACTIVATE LOGGING 
INITIALIZE LOG DATA SET 
TERMINATE LOGGING 
REISSUE COMMAND LIST 



CANCEL($C) THIS PROGRAM. 
LOGGING ACTIVATED 
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$MOVEVOL - DISK VOLUME DUMPXRESTORE 



\ y 



$MOVEVOL dumps the contents of an Event Driven Executive direct 
access volume to diskette when such a volume spans several 
d i skettes . 

$MOVEVOL also restores a volume from diskette to disk. Thus, 
$MOVEVOL provides the facility for transferring large amounts 
of data from one system to another or for creating backup 
copies of an online data base. 



Diskette Uss^ge 



Diskette Contents 



The first of the set of diskettes used for the dump function, 
called the control diskette, records control information and 
the volume directory. The rest of the diskettes store the data 
portion of the volume being dumped. Control information is 
recorded on each data diskette to identify the diskette con- 
tents and to ensure that it contains data related to the dump 
operation described on the control diskette. 



\,-y 



Pi skette Format 



All diskettes must be formatted using $DASDI to contain 
128-byte sectors. Either single-sided or double-sided 
diskettes can be used; however, all diskettes in a set must be 
the same type. Each diskette must contain a volume label in the 
standard format. The volume label must be a six-character field 
in which the last two characters are used for sequencing; for 
example, SAVEOO, SAVEOl, ..., SAVEnn, where nn is the last 
diskette used. All diskettes used must have the same four- 
character prefix. 
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$MOVEVOL 



If you are using the 4966 diskette magazine unit for your 
dump/restore operation, you can use diskette magazines or an 
individual diskette slot. If you use an individual diskette 
slot, then all of the subsequent diskettes mounted must be 
placed in the same slot. If you use diskette magazines, you 
must have all of your diskettes in the correct sequence with no 
empty slots in the magazine. The first volume with the suffix 
00 must be in slot number 1 of the first magazine. You can use 
either or both of the diskette magazines, A and B. 



Data Set Specification 



If $MOVEVOL is invoked with the $L command, you are prompted to 
enter the names of the data sets and volumes to be used. 






Figure 21 shows the parameter menu displayed when $MOVEVOL is 
invoked using the session manager. Enter the requested infor- 
mation and press ENTER. 



$SMM0308: SESSION MANAGER $MOVEVOL PARAMETER INPUT MENU- 
ENTER/SELECT parameters: DEPRESS PF3 TO RETURN 



DISK 



($$EDXLIB, VOLUME) ==> 



DISKETTE (NAME, VOLUME) ==> 



I Figure 21. $MOVEV0L parameter input menu 
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Dump Procedure 



\^/ 



The following steps are required to dump the 
direct access volume onto diskette. 



contents of 



1. 



Set up a control diskette, 
a. Use $INITDSK to: 
1) 



2) 



Initialize 


the 


control 


d i skette 


wi th 


a vol ume 


label that 


i 5 


s u f f i X e d 


with 00 


(for 


examp le t 


SAVEOO) . 













Create a directory of at least 2 records. 



3) If the diskette is to be used to IPL another sys 
tem» reserve space for a nucleus of the appropri 
ate size and write the IPL text. 



Use $DISKUT1 to: 



1) 



Determine the directory size* 
volume to be dumped. 



in records* of the 



2) 



Change volume to the control diskette (for exam- 
ple* SAVEOO) and allocate a control data set with 
the same name as the name of the volume to be 
dumped. The member size of the control data set 
must be one record larger than the size of the vol- 
ume being dumped. 

c. Use $C0PYUT1 to: 

1) Copy other data sets onto the control data set. For 
example, you may required $EDXNUC, the transient 
loader, or a copy of $MOVEVOL. 

Note : The first record in the control data set 
contains control information and up to 50 charac- 
ters of text describing the data being dumped. The 
remaining space stores a copy of the directory of 
the volume being dumped. 

2. Set up a series of data diskettes. For each data diskette: 

a. Use $INITD5K to: 

1) Create a volume label. The volume label of each 
diskette must have the same four-character prefix 
as the control diskette and a two -character suffix 
indicating the sequence number, for example. 
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SAVEOl, SAVE02, , SAVEnn. 

2) Create an owner ID field. 

3) Allocate a two-record directory, 
b. Use $DISKUT1 to: 

1) Allocate a one-record data set named $CONTROL. 

2) Allocate a second data set with the name of the 
volume to be dumped (for example^ EDX002). The 
second data set must use the remaining available 
space on the diskette (9^6 records for a single- 
sided diskette and 1921 records for a double-sided 
diskette. 



Mount the control diskette, 
$MOVEVOL for execution. 



vary it online and load 



You must specify two data sets at load time: 

DISK The volume on disk to be dumped. Specify 
$$EDXLIB, volser . 



DISKETTE The control data 
dsname » vo Iser . 



set 



on 



diskette. Specify 



$MOVEVOL asks if you wish to dump from disk to diskette. 

$MOVEVOL then determines the number of additional 
diskettes required to dump the referenced volume (DISK)» 
informs you of this requirement, and asks whether the 
procedure should be continued. A negative response termi- 
nates the operation. If the response is positive, the con- 
trol information and disk directory are recorded on the 
control diskette and you are asked to mount a new diskette 
for transfer of the data portion of the volume being 
dumped . 

Each time a diskette is filled, $MOVEVOL requests another 
diskette. Mount as many data diskettes as requested. 
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Exsimple 

Dump Operation Using a <^966 Diskette Ma g azine Unit 



o 



> $L $MOVEVOL 
DISK (NAME, VOLUME) : $$EDXLIB, EDX002 
DISKETTECNAME, VOLUME) : $EDX002, SAVEOO 

$MOVEVOL 20P, 10:07:52, LP=5200 

DUMP LIBRARY FROM VOLUME EDX002 TO DISKETTE? Y 



) 



PROCESSING DISKETTE VOLUME SAVEOO 
ENTER LIBRARY IDENTIFICATION (1-50 CHAR 
DUMP OF EDX002 - DATE IS 09/1^/77 

11 MORE DISKETTES ARE REQUIRED, CONTINUE? 



PROCE 
PROCE 
PROCE 
PROCE 
PROCE 
PROCE 
PROCE 
PROCE 
PROCE 



SSING 
SSING 
SSING 
SSING 
SSING 
SSING 
SSING 
SSING 
SSING 



DISKETTE 
DISKETTE 
DISKETTE 
DISKETTE 
DISKETTE 
DISKETTE 
DISKETTE 
DISKETTE 
DISKETTE 



VOLUME 
VOLUME 
VOLUME 
VOLUME 
VOLUME 
VOLUME 
VOLUME 
VOLUME 
VOLUME 



SAVEOl 
SAVE02 
SAVE03 
SAVEO-^ 
SAVE05 
SAVE06 
SAVE07 
SAVE08 
SAVE09 



MOUNT NEXT DISKETTE OR MAGAZINE 
REPLY -Y- NHEN DONE: Y 

PROCESSING DISKETTE VOLUME SAVEIO 
PROCESSING DISKETTE VOLUME SAVEll 

VOLUME DUMP OPERATION COMPLETE 
9200 RECORDS TRANSFERRED 

$MOVEVOL ENDED 10:10:13 
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Restoration Procedure 



The following steps are required for a restore operation. 

1, Mount the control diskette! vary it online and load 
$MOVEVOL for execution. 

a. Respond as described previously in Dump Procedure to 
requests for data sets. 

b. Select the restoration mode by responding N to the 
query for disk to diskette dump and Y to the query for 
diskette to disk restoration. 

2. Mount data diskettes as requested. 

Examples 

Restore Operation Using a <^96^ Diskette Unit J The source is 
smaller than the receiving volume in size. 



> $L SM0VEV0L,GREYV2 

DISK (NAME, VOLUME) : $$EDXLIB,MACLIB 

DISKETTECNAME, VOLUME) : SMACLIB^BACKOO 
$MOVEVOL 20P, 00:26:08, LP= 7000 
DUMP LIBRARY FROM VOLUME MACLIB TO DISKETTE? N 

RESTORE LIBRARY FROM DISKETTE TO DISK VOLUME MACLIB ? Y 

RESTORING 5719-XX2 VOlMOl JAN. 12, 1979 TO VOLUME MACLIB 

CONTINUE? Y 

SOURCE VOLUME IS SMALLER THAN THE TARGET. CONTINUE? Y 

COMPRESS THIS LIBRARY AFTER INSTALLATION. 

PROCESSING DISKETTE VOLUME BACKOO 

MOUNT NEXT DISKETTE OR MAGAZINE 

REPLY -Y- WHEN DONE: Y 

PROCESSING DISKETTE VOLUME BACKOl 
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Restore Operation Using an Individual <^966 Diskette Magazine 
Slot : The source and target volumes are equal in size. 



1 



.J 



> $L $MOVEVOL $$EDXLIB,EDX003 $EDX003, SAVEOO 

$f10VEV0L 20P,11 :05:05, LP = 6300 

DUMP LIBRARY FROM VOLUME EDX002 TO DISKETTE? N 

RESTORE LIBRARY FROM DISKETTE TO DISK VOLUME EDX002? Y 
RESTORING DUMP OF EDX002 - DATE IS 09/14/77 
CONTINUE? Y 

PROCESSING DISKETTE VOLUME SAVEOO 
MOUNT NEXT DISKETTE OR MAGAZINE 
REPLY -Y- WHEN DONE: Y 

PROCESSING DISKETTE VOLUME SAVEOl 
MOUNT NEXT DISKETTE OR MAGAZINE 
REPLY -Y- WHEN DONE: Y 

PROCESSING DISKETTE VOLUME SAVE02 
MOUNT NEXT DISKETTE OR MAGAZINE 
REPLY -Y- WHEN DONE: Y 

PROCESSING DISKETTE VOLUME SAVE03 
MOUNT NEXT DISKETTE OR MAGAZINE 
REPLY -Y- WHEN DONE: Y 

PROCESSING DISKETTE VOLUME SAVEOO 

VOLUME INSTALLED 

3600 RECORDS TRANSFERRED 

$MOVEVOL ENDED 11.10.56 



H^. 
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$PFMAP - IDENTIFY ^978 PROGRAM FUNCTION KEYS 



The $PFMAP utility identifies the program function keys on the 
A978 display station. As each key is pressed* its associated 
system code is displayed in decimal and hexadecimal. A key's 
associated system code is the identification returned at com- 
pletion of a WAIT KEY instruction or an ATTNLIST interrupt. 
The hardcopy key is active during execution of this program* 
and its code is not displayed. The program is terminated by 
pressing the ENTER key. 



uV 
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SPREFIND - PREFIND DATA SETS AND OVERLAYS 






$PREFIND locates the disk* diskette* or tape data sets and 
overlay programs to be referenced by your program and stores 
their addresses in the header of your program. After $PREFIND 
has executed* the tasks performed by $LOADER are reduced and 
future program load times for the your program are shortened. 

Under certain carefully controlled conditions* $PREFIND 
reduces the time required to load other programs from disk or 
diskette for execution. $PREFIND is normally used as the last 
step in the program preparation process* following the 
execution of ^UPDATE* however* it can be used to process a pro- 
gram at any time after the program has been processed by $UP- 
DATE or after a previous processing by $PREFIND as is described 
as f ol lows . 

$PREFIND is most effective when it is used to process programs 
that reference a large number of disk* diskette* or tape data 
sets and overlay programs and when these programs must be 
loaded frequently from disk or diskette. 



Program Load Process OvervieN 

If a program uses data sets or overlays programs (DS= and PGMS = 
keyword parameters in PROGRAM statement)* the assembly process 
creates control blocks in the program header for each data set 
and overlay program specified. Space is reserved in these con- 
trol blocks for the physical disk /diskette /tape addresses of 
the data sets and overlay programs defined. 

After completion of the program preparation process ($LINK if 
required* and then $UPDATE)> the executable load module can be 
loaded to storage. The system program that performs the load 
operation is a transient loader program ($LOADER)> and part of 
that operation includes filling in the actual physical 
addresses of data sets and overlay programs in the control 
blocks of the program header of the program that was loaded. 
When a large number of data sets and/or overlay programs are 
defined* this can be a time-consuming process* as $LOADER must 
search a volume directory for each data set/program used. 

In this manner* all data sets and overlay programs required by 
a program are located and their sizes determined each time the 
using program is loaded for execution. Thus* the loaded pro- 
gram will execute correctly even if the size or location of one 
or more of the data sets or overlay programs it uses has 
changed . 



^.-.y 
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The program loading process just described provides maximum 
safety and flexibility in loading programs for execution. Hoh- 
ever, the time required to locate each data set and overlay 
program each time a program is loaded may be undesirable in 
some circumstances. 

$PREFIND allows data sets and overlay programs to be located 
prior to program load time, and written directly into the pro- 
gram header on disk or diskette. Nhen a program is loaded, the 
information required is already present, and load time is 
therefore reduced. 

Note : See Internal Design for a description of the Relocating 
Program Loader ($LOADER), the program header, and Data Set Con- 
trol Blocks (DSCBs) . 



$PREFZND Usage Cautions 






Use $PREFIND only to locate data sets and/or overlay pro- 
grams in well tested production systems where the size and 
location of the referenced data sets and overlay programs 
are unlikely to change and where programs are loaded so 
frequently that the saving of a few seconds in program load 
time results in a useful performance increase for the sys- 
tem. 



Use $PREFIND only in situations where the disk, diskette, 
or tape locations of referenced data sets and overlay 
programs will remain relatively static. If a referenced 
data set or overlay program is moved to a new location on 
disk or diskette, or to another tape volume, then programs 
that have been processed by $PREFIND will not be aware of 
the new location or size. This will produce undesirable 
results the next time the programs are executed. 

$PREFIND must be used again to insert the new information 
into the program headers of all referencing programs. 

Before loading a program that references data sets on 
removeable media, such as diskette or tape, make sure that 
the proper diskette or tape volume containing the prefound 
data sets has been mounted and varied online. If the cor- 
rect diskette or tape volume is not mounted, the program 
will use whatever volume is mounted at the time of exe- 
cution. If you should access an incorrect volume, unpre- 
dictable results may occur and possible destroy the data on 
the diskette or tape. 
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The system does not keep track of referenced data sets or 
overlay program locations that are no longer valid. It is 
your responsibility to prevent disk» diskette, or tape 
data sets and program overlays from being incorrectly mod- 
ified. 

System functions that can change the size or location of 
data sets or overlay programs are? 

DE and AL commands of $DISKUT1 

CD, ST, and RT commands of $TAPEUT1 

$C0PYUT1 

$UPDATE, following reassembly of a program 

$COMPRES 



o 



If you generate a new system and IPL from that system, make 
sure that the disk, diskette, or tape control blocks have 
not been relocated. A change in control block location 
within the supervisor requires that $PREFIND be used again 
to locate any referenced data sets and overlay programs. 

Changes made during system generation that can affect the 
location of control blocks are? 

• Adding, deleting, or changing $EDXDEF statements. 

• Modifying the $LNKCNTL data set to add additional 
INCLUDE statements . 

• Relinking the supervisor with new or modified object 
modules, for example, $SYSCOM or PTF module replace- 
ments . 



\-J 



$PREFIND Commands 



The $PREFIND commands are listed below. When invoked using $L, 
$PREFIND prompts you for the information required for each com- 
mand. When invoked through $JOBUTIL as a batch processing job, 
$PREFIND must be supplied with the necessary information with 
the PARM command of $JOBUTIL, as described on the following 
pages . 






y 
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Command 

PF 
DE 
EN 

9 



Descr i pt i on 

PRELOCATE DATA SETS AND OVERLAYS 

DELETE PREFOUND STATUS 

END $PREFIND 

LIST AVAILABLE COMMANDS 



Invoking $PREFIND 



$PREFIND can be invoked by the $L command, the job stream 
processor ($JOBUTIL), or the program preparation option of the 
session manager. 



Invoking $PREFIND Using $L 



When invoked with $L» $PREFIND prompts you for the command name 
and, if either PF or DE is entered, prompts you for the name and 
volume of the program, as well as the numbers (1 through 9) of 
the data sets and overlay programs that are to be located or 
whose prefound status is to be deleted. All of the reguired 
information can be entered without waiting for the prompting 



messages. For example* 



PF MYPROG,EDX003 D=:(l,2,^,7) P=(l,2,3) 



here the numbers in par^enthesis correspond to the numbers used 
in the DSn and PGMn parameters on the READ/WRITE and LOAD Event 
Driven Language instructions. 

The data set and program numbers must always be entered in the 
formats D=(_,__,_) and P = (_»_). Data set numbers, if present, 
must always precede overlay program numbers. The word ALL can 
be used in place of the number string within the parenthesis if 
desired. A null response to the prompt for either (but not 
both) the data set or program numbers can be made, if appropri- 
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ate> and no change in the status of the data sets or programs 
will occur . 

Only those data set or program numbers whose status is to be 
changed should be entered. For example» if a program refer- 
ences six data sets and it is desired to prelocate the first 






commands described S'bove* data sets 1» 2> and 6 would be pre- 
found and data sets 3» ^h* 5 would not. In the example given 
here* the execution of the DE command only affects DS3 and does 
not update the information in the program header concerning 
DSlf DS2» or DS6 should they have been moved to different 
locations on disk betweenthe execution of the PF and DE 
commands described. 

Njo te. i During execution of the DE command* a data set can be 
deleted which was originally defined in the format 
(dsname*??). In this case* $PREFIND prompts you to enter the 
prompting dsname to be placed back into the program header 
since the original name was overridden during the previous PF 
command. If the DE command is invoked via $JOBUTIL» an error 
message occurs if the above condition is encountered. 

Any data set or overlay program not marked as being in the pre- 
found state is located by $LOADER whenever the using program is 
loaded into storage for execution. 

Examples 

Processing One Program Without Prompting Messages 






> SL $PREFIND 

$PREFIND 22P*00:06:15, LP= 9800 

COMMAND (?): PF TESTPREF, EDXOOl D= ( 1, 2, 3,5, 7* 9) P=(ALL) 

COMMAND COMPLETED 
COMMAND (?): EN 

$PREFIND ENDED AT 00:07:30 



^Uuj'^ 
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Processing Multiple Programs with/without Prompting Messages 



> 



COMMAND (?): PF 

PGMCNAME, VOLUME) : TESTPREF, EDXOOl 
ENTER DATA SET NUMBERS: D= ( 1, 2, 3, 7, 9 ) 
ENTER OVERLAY PGM, NUMBERS: P=(ALL) 

COMMAND COMPLETED 
COMMAND (?): 



COMMAND (?): PF 

PGMCNAME, VOLUME) : TESTPRE2, EDXOOl D=(ALL) P=(ALL) 

COMMAND COMPLETED 
COMMAND (?): EN 

$PREFIND ENDED AT 00:10:59 
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Invoking $PREFIND Using $JOBUTIL 



When $PREFIND is invoked through $JOBUTT.L, it requires the same 
information as Nas described under 'Invoking $PREFIND Using 
$L*. This information is provided with a FARM command having 
the format shown below. The number of spaces between the oper- 
ands in the FARM command may be one or more* as long as the 
total number of characters* including spaces* does not exceed 
62. 

Syntax 



Character 

Pos i t i on 

1 10 

FARM progname » volume c 



D=(. 



,» 



) P=(. 



, » __ . 



Operands Descr i pt i on 

progname The name of the program whose data set and overlay 
program status is to be modified. 



r...;.y 



volume The volume of residence of the program whose data 
set and overlay program status is to be modified. 

c Either character P for FREFIND or character D for 

DELETE 

_»_»__ The string of data set or overlay program numbers* 
or the word ALL 

When invoked with $JOBUTIL» $PREFIND performs either a single 
prefind or delete function and then terminates its execution. 
$PREFIND directs its error and/or termination messages to the 
device defined as $SYSPRTR. 



o 
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Example 



Messages and responses on your terminal: 

> $L SJOBUTIL 

$JOBUTIL 3P, 02:23:15, LP= 6500 

ENTER PROCEDURE (NAME , VOLUME ) : PREPROC, EDXOOl 

$JOBUTIL ENDED AT 02:23:38 



Output on $SYSPRTR: 

LOG $SYSPRTR 
*^^ JOB - PREFIND 



STARTED AT 02:23:28 00/00/00 ^^^ 



JOB PREFIND 

PROGRAM $PREFIND,EDX0 01 

NOMSG 

FARM D TESTPREF,EDX001 D=(ALL) P=(ALL) 

EXEC 

COMMAND COMPLETED 

$PREFIND ENDED AT 02:23:37 



The procedure used: 



00010 LOG 
00020 JOB 



$SYSPRTR 
PREFIND 



00030 PROGRAM $PREF IND , EDXOOl 
OOO'^O NOMSG 



00050 FARM 
00060 EXEC 
00070 EOJ 



D TESTPREF,EDX001 D=(ALL) P=(ALL) 
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Invoking $PREFIND Using the Session Manager 



\.J 



The session manager option menu for program preparation can be 
used to invoke $PREFIND, Selection of $PREFIND causes the fol- 
lowing parameter option menu to be displayed? 



$SMM0208; SESSION MANAGER $PREFIND PARAMETER INPUT MENU-- 
ENTER/SELECT PARAMETERS DEPRESS PF3 TO RETURN 



COMMAND (P/D) 
PROGRAM (NAME, VOLUME) 
DATASET #»S (OR ALL) 
PROGRAM #'S (OR ALL) 



= > D 

=> TESTPREFiEDXOOl 
= > ALU 
= > ALL 



After the parameters are entered, $PREFIND executes as if it 
were invoked using $JOBUTIL. 






€ 



y 
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$TAPEUT1 - TAPE MANAGEMENT 



%, 



$TAPEUT1 performs several commonly used tape management func- 
tions. You can initialize tapes^ allocate tape data sets* copy 
data sets or volumes to or from tape, copy tape to tape» print 
tape records, dump/restore disk devices, and test the tape 
transport hardware. 

$TAPEUT1 is invoked with the $L command or primary option 3 of 
the session manager. Once invoked and prior to accepting com- 
mands, $TAPEUT1 displays the following information about the 
tapes defined to the system: 

TAPEID 



density selection (800, 1600, DUAL) 

label type (SL, NL, BLP) 

current density setting 

onl i ne or offline 

volume information (if an online SL tape) 

device address 



Example: Loading $TAPEUT1 and its automatic display of the sys 
tern tapes . 



> $L STAPEUTl 

$TAPEUT1 21P, 11:11:33, LP= 

TAPEOl DUAL SL 1600 OFFLINE 

DEVICE ADDRESS = 00-^0 
TAPE02 DUAL NL 1600 OFFLINE 

DEVICE ADDRESS = 004D 

COMMAND (?): 



0000 



Note : Error logging of tape errors 
System Guide . 



is available. Refer to the 
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STAPEUTl Commands 



Ay 



The commands available under $TAPEUT1 are listed below. To dis- 
play this list at your terminal* enter a question mark in reply 
to the prompting message COMMAND (?):. 



COMMAND (?): ? 

CD - COPY DATASET 

CT - CHANGE TAPE ATTRIBUTES 

DP - DUMP TAPE 

EN - END $TAPEUT1 

EX - EXERCISE TAPE 

IT - INITIALIZE TAPE 

MT - MOVE TAPE 

RT - RESTORE DISK/VOL FROM TAPE 

ST - SAVE A DISK/VOL ON TAPE 

TA - ALLOCATE TAPE DATASET 

COMMAND (?): 



\. ,y 



After the commands are displayed, you are again prompted with 
COMMAND (?)J. You respond with the command of your choice (for 
example, CD). 



c 
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I CD - Copy Data Set 



CD copies a disk or diskette data set onto a tape» copies a tape 
data set into a disk or diskette data set or onto another tape. 
The command writes a trailer label at the end of the data set on 
the target tape if it is a standard label tape. Header labels 
are not written on standard or non-labeled tapes, therefore, 
the target tape data set must be prea 1 located . 



If a disk or diskette data set is being copied to tape, the tape 
records will be 256-bytes. If a tape data set from another sys- 
tem (for example, a S/370) is copied to a disk or diskette and 
the source records are not 256-bytes, the source records are 
split into multiple 256-byte records with any unused bytes pad- 
ded with zeros. Prior to copying, you are prompted for the 
maximum input record size. 

I Consider the following when you are copying data sets: 

• Nhen you reach a tapemark (end of input data), you are 
prompted to continue. If you have more records to copy, you 
can continue; however, make sure that there is sufficient 
room on the target tape. You are prompted at every tapemark 
encountered on the source tape. If you do not wish to con- 
tinue, the trailer label is written on the target tape. 

• To copy the contents of one tape to another tape, thereby 
creating an exact duplicate of the entire tape (header 
label and data records or only data records), you can use 
either of two methods? 



To copy only data records, initialize the target tape 
(using the IT command) so that it has the same label 
type as the source tape. Copy (using the CD command) 
the source tape to the target tape. This allows you to 
create a new header label on the target tape and to 
duplicate only the data records from the source tape. 



To create an exact duplicate of the source tape, mount 
the source and target tapes on drives specified for 
bypass label-processing. Then copy (using the CD com- 
mand) the entire source tape. The target tape becomes 
an exact duplicate of the source all label records, all 
data records, and all trailer labels). 
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I Example 

I C opying Data from a Disk to a Tape 



>^ 



COMMAND (?): CD 

SOURCE (NAME, VOLUME) .• $TAPEUT1 , EDX002 
TARGET (NAME, VOLUME) : DATAllll, 123^56 
ENTER SOURCE BLOCKSIZE ( NU L L=DISK ( ETTE ) ) 
USE ATTN/CA TO CANCEL COPY 



ARE ALL PARMS CORRECT? 
EOD ON SOURCE DATASET 
25 RECORDS COPIED 

COMMAND (?): 



(Y,N) 



( 
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CT - Change Tape Drive Attributes 

CT resets the label type and density for any tape drive. The 
label type and density are set at system generation. CT allows 
you to dynamically reconfigure the tape drives. You must vary 
off the tape drive before you can change its attributes. 



CT nn 



I where nn = hexadecimal device address 



o 



The current settings for label and density are displayed. You 
are prompted to enter any changes. 



he CT command fails and issues an error message on the termi- 
al for the following conditions: 

invalid device address 

tape drive is not varied offline 

invalid label type 

invalid density 

tape drive not defined as dual density 
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Examples 



Spe cify Changes to the Label Processing and Density Selection 
for Tape Drive at Address <^C. 



COMMAND (?): CT TAPEOl 

ENTER TAPEID (1-6 CHARS): TAPEOl 

TAPE TAPEOl AT ADDR 4C IS BLP 1600 BPI 

DO YOU WISH TO MODIFY (Y OR N)?: Y 

LABEL (NULL, SL,NL, BLP)?: SL 

DENSITY (NULL, 800, 1600) : 800 

TAPE TAPEOl AT ADDR ^C IS SL 800 BPI 

COMMAND (?): 



No Chang es are Made for Label Processing and Density Selection 
for Tape Drive at Address '^D. 



COMMAND (?) : CT TAPE02 

ENTER TAPEID (1-6 CHARS): TAPE02 
TAPE TAPE02 AT ADDR ^D IS SL 800 BPI 
DO YOU WISH TO MODIFY (Y OR N)?: N 

COMMAND (?): 



K-.-j^ 
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I DP - Dump Records 



DP dumps tape record(s) on the system printer ($SYSPRTR)» on 
the terminal from which you invoked $TAPEUT1, or on the termi- 
nal you specify. The output format is similar to the $DISKUT2 
utility; hexadecimal data plus the EBCDIC conversion. 



The record number for each record is shown and the words 
'tapemark' are printed when a tapemark is encountered. You are 
prompted for the number of records to be printed. Nhen a 
tapemark is detectedi you are prompted to continue or to termi- 
nate the dump , 



You are prompted for the maximum record size. This allows you 
to print record sizes up to the maximum amount of storage 
available. If the record being read is smaller orlarger than 
the maximum size specified, a message will be issued indicat- 
ing : 



a wrong length record was encountered 



the actual record size 



Smaller records are printed and padded with zeros. Larger 
records are truncated and printed to the maximum size speci- 
fied. You are informed of the actual record size. 



I Notes: 



1. 



The tape 
records . 



must be varied offline before you can dump 



2. The TAPEID specified must match the one specified at system 
gener at i on . 



3. This is an offline utility; therefore, the tape will not be 
automatically rewound when the dump is finished. Use the 
move tape command (MT) to rewind the tape. 



A. The dump command (DP) and the move tape command (MT) can be 
used together to selectively search and dump portions of a 
tape . 
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Exiample 

D ump F iv e Records on Display Ter minal 



COMMAND (?): DP 

ENTER MAXIMUM BLOCKSIZEs 256 
USE ATTN/CA TO CANCEL DUMP 
ENTER TAPEID (1-6 CHARS): TAPEOl 
ENTER NUMBER OF RECORDS TO DUMP: 5 
PRINT DUMP ON $SYSPRTR? (Y,N): N 
ENTER TARGET TERMINAL NAME (?f,NAME): >« 

(The dump is directed to the terminal 
you are currently assigned to) 

COMMAND (?): 



To direct the dump to the $SYSPRTR or to a terminal of your 
choice, you are prompted and can respond as follows: 

Y Print dump on $SYSPRTR 

N Display dump on the terminal of your choice. You are 
prompted for the terminal name and can respond as fol- 
io n s : 

• ^ = terminal on which you are currently assigned 

• name = device name of the target terminal 

If the tape you want to dump is currently in use, you are 
prompted as follows: 






DEVICE NOT OFFLINE 

DO YOU WISH TO CONTINUE? (Y,N): 



If you specify Y, the dump will continue but the device will be 
unuseable by the original user. 
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I EX - Exercise Tape 

j EX» a software exerciser, performs two operations: 

• It exercises any of the three label type tapes to ensure 
that the I/O commands to that tape are executing correctly, 

• It analyzes the surface of the tape to verify that the sur- 
face is free of defects. Any errors and their approximate 
location on the tape are printed on the system printer 
($SYSPRTR) . 

Cauti on i Surface analysis writes records over the information 
currently on the tape. Any existing data records or labels are 
destroyed . 

Each operation is optional and you are prompted before continu- 
ing. 

The EX command performs the following functions: 

• Writes 600 unique records to a data set on the tape 

• Closes and reopen the data set 

• Finds a particular record within the data using NOTE/POINT 

• Verifies that the correct record is accessed 

• Performs a surface analysis of the tape by writing over the 
tape and then verifies each record. 
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Example 



COMMAND (?): EX 

TARGET (NAME, VOLUME: MYDATA, 123^56 

USE ATTN/CA TO CANCEL THE EXERCISER 

DO YOU WANT TO EXERCISE THE SOFTWARE (Y/N): Y 

• • • 

Exerciser runs and prints status on printer 

• • • 

WRITE/READ ENTIRE SURFACE OF TAPE? (Y/N): Y 

Exerciser writes on entire surface of tape, then 
reads and verifies each record 

TAPE EXERCISER ENDED 



A sample of the data printed by the EX command follows. 
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TAPE EXERCISER STARTED 

NRITE 600 UNIQUE RECORDS TO TAPE 

TEST DATA WRITTEN 

STEP 1 SUCCESSFUL 

CLOSE DATASET FOR REUSE 

STEP 2 SUCCESSFUL 

READ 250 OF THE RECORDS 

NOTE PRESENT POSITION 

STEP 3 SUCCESSFUL 

POINT TO RECORD 150 AND READ THAT RECORD 

STEP ^ SUCCESSFUL 

NOTE PRESENT POSITION 

STEP 5 SUCCESSFUL 



J 



CLOSE 

STEP 

REOPE 

READ 

ATTEM 

VERIF 

STEP 

VERIF 

STEP 

WRITE 

THIS 

DO YO 

RENIN 

STEP 

WRITE 

WRITE 

STEP 

RENIN 

STEP 

READ 

RENIN 

STEP 

CLOSE 

STEP 



DATASET FOR REUSE 

18 SUCCESSFUL 
N THE DATASET 

598 OF THE RECORDS 

PT TO READ MORE RECDS WITH 1 STMT THAN ARE AVAILABLE 

Y END-OF-DATA RETURN CODE 

19 SUCCESSFUL 

Y 2ND WORD OF TCB CONTAINS ACTUAL # REALLY READ 

20 SUCCESSFUL 

/READ ENTIRE SURFACE OF TAPE? V 
SECTION WILL DESTROY ALL LABEL FIELDS 
U WISH TO CONTINUE? (Y,N): Y 
D TAPE TO LOAD POINT 

21 SUCCESSFUL 
RE TAPE 
MARKS ON END OF TAPE 

22 SUCCESSFUL 
D TAPE TO LOAD POINT 

23 SUCCESSFUL 
ERIFY ALL THE RECORDS 
E TO LOAD POINT 

2^ SUCCESSFUL 
OFFLINE 
25 SUCCESSFUL 



ENTI 
TAPEI 



AND VI 
D TAPI 

TAPE 



o 



TAPE EXERCISER SUCCESSFUL 
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IT - Initialize Tape 

IT completely initializes a new tape^ or changes the label 
information on a used tape. The IT command initializes tapes 
for non-labeled and standard label use. 

When you initialize a tape as non-labeled, the IT command 
writes three tapemarks deleting any previous labels on the 
tape . 

When you initialize a tape as standard label* the IT command 
writes on the tapet 

• a volume label (VOLl) 

• a header label (HDRl) 

• 2 tapemarks to delimit the label information and to indi- 
cate aji empty data set 

• a trailer label (EOFl) and 2 tapemarks signifying the end 
of data on the tape 



o 



You are prompted for the the contents of all required label 
f i elds . 

Example 






COMMAND (?): IT TAPEOl 

ENTER TAPEID (1-6 CHARS): TAPEOl 

STANDARD LABEL 1600 BPI? Y 

TAPEDS (NAME, VOLUME) : DATAllll, 123456 

OWNERID (1-10 CHARS): OWNER-ID 

EXPIRATION DATA (YYDDD): 79001 

TAPE INITIALIZED 

COMMAND (?): 



Notes : 

1, Your tape must be varied offline before you can initialize 
it. If the tape is not offline, a warning message is issued 
and you are prompted to continue. 
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2. 



$TAPEUT1 



If you are changing the label information on a used tape* 
you must use the EX parameter of $VARYON to override an 
unexpired expiration date. 



3. Your tape is initialized with the same attributes (label 
and density) as those defined for the tape drive on which 
the tape is mounted. Refer to the TAPE statement in the 
System Guide , 



A, When specifying the volume and data set names, do not use 
the same names as were specified for tape ID at system gen- 
eration. 



C>^ 
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MT - Move Tape 

MT provides functions to the terminal user that control tape 
motion on the specified tape. The available control functions 
are t 

BSF - Back space file 

BSR - Back space records 

FSF -- Forward space file 

FSR - Forward space records 

OFF - Set device offline 

REM - Rewind 

ROFF - Rewind of f 1 ine 

WTM - Write tapemark 

A count is available for FSR, BSRi FSF, BSF, and WTM so that you 
can specify the number of records to be spaced over or the 
number of tapemarks to be written. 

An EOT (end-of -tape ) terminates only the write tapemark (WTM) 
function and issues a return code. If you wish to proceed past 
the EOT, you must request another WTM. 



V_y 



Notes : 

1. You can proceed past the EOT, however, make sure that there 
is sufficient tape to perform the operation. 

2. The tapemark record is smaller than the end-of-tape (EOT) 
indicator so you could possibly receive two or more end- 
of-tape indications for the same EOT. 

A tapemark terminates FSR or BSR operations and the tape is 
positioned following that tapemark. 



o 
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I Example 

I Move TAPEOl Forward 3 Records 



COMMAND (?): MT 

ENTER TAPEID (1-6 CHARS): TAPEOl 

TYPE? FSR/BSR/FSF/BSF/WTM/REW/ROFF/OFF: FSR 3 

^ the action occurs ^ 

FSR SUCCESSFUL 

TYPE? FSR/BSR/FSF/BSF/WTM/REW/ROFF/OFF: END 

$TAPEMT ENDED AT 00:20:39 

COMMAND (?): 






If the tape was positioned at the first record and the utility 
forward spaces 3 records, the tape is positioned at the <^th 
record . 



I Notes: 



1. Your tape must be varied offline before you can issue the 
motion commands. If the tape is not offline* a warning mes- 
sage is issued and you are prompted to continue. 

2. The response to 'ENTER TAPEID' must be the same TAPEID that 
wasspecifiedatsystemgeneration. 

3. This is an offline utility; therefore* the tape will not be 
repositioned or rewound when it end. Use the MT command to 
rewind the tape. 
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RT - Restore Disk or Disk Volume From Tape 

RT restores a disk or disk volume from a tape. The tape must 
have been previously created using the ST command. You can 
restore a disk volume from a tape to the same device type or a 
different device type» except for the IPL volume. (The IPL vol- 
ume is treated similarly to the disk device? it must be 
restored to the same device type). To restore an entire disk 
device from tape* the device type and model number of the 
source and target disks must match. 

Certain conditions (for example* disaster recovery) can make 
it necessary to restore an entire disk from tape. To perform a 
restore when the disk has been destroyed* the following proce- 
dure is suggested since tape support is not included in the 
distributed starter system: 



( 



■> 



1. Create on a diskette a nucleus that includes tape support 
and include $TAPEUT1 on the diskette. Keep this diskette 
with the backup tapes you create with the ST command. 

2. When a restore is necessary* IPL with this diskette* 
restore the disk from the backup tapes, and IPL from the 
restored disk. 

To create the diskette that you will IPL: 

1. Use your current system with tape support included 

2. Use $INITDSK to initialize and write IPL text on the 
diskette with the following attributes: 

• DIRECTORY SIZE=3 
CREATE NUCLEUS?: Y 

• SIZE=64 

• IPL TEXT?: Y 



% 



3. Copy the current system using $COPY (CD) onto the diskette 
as f ol lows : 

• source: $EDXNUC,EDX002 

• TARGET: $EDXNUC , d i skette ID 



4. Use $C0PYUT1 (CM) to copy the following modules to the 
d i skette : 

$ LOADER 



o 
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• $TAPEUT1 

• $TAPERT 

• Your terminal support (for ^978/4979 support* copy 
$^978IS0 and $^978CS0) 

With this procedure* you create a diskette copy of the IPL text 
and support modules necessary to IPL your system and restore 
the disk from tape without generating your system again. 

Examples 

Restore Volume from a Tape 



> $VARYON ^C 

TAPEOl ONLINE 

> $L $TAPEUT1 

$TAPEUT1 19P, 00:08:^8, LP= 7A00 
TAPEOl DUAL NL 1600 ONLINE 

DEVICE ADDRESS = 004C 
TAPE02 SL 1600 OFFLINE 

DEVICE ADDRESS = OO^D 

COMMAND (?): RT 

^ WARNING: TO ENSURE PROPER ^ 

^ DISK CONTENTS, THE SYSTEM ^ 

^ SHOULD BE INACTIVE WHILE ^ 

^ RUNNING THIS UTILITY ^ 



SOURCE (NAME, VOLUME) : 
TARGET (NAME, VOLUME) : 
DEVICE RESTORE? N 
ARE ALL FARMS CORRECT? 



X, TAPEOl 
$$EDXVOL,ASMLIB 

(Y,N) : Y 



USE ATTN/CA TO CANCEL THE RESTORE 

VOLUME RESTORED 
COMMAND (?): 
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Restore Disk Device from a Tape 



> $VARYON 4C 

TAPEOl ONLINE 

> $L $TAPEUT1 

$TAPEUT1 19P, 00:12:06, LP= 7A00 
TAPEOl DUAL NL 1600 ONLINE 

DEVICE ADDRESS = 004C 
TAPE02 SL 1600 OFFLINE 

DEVICE ADDRESS = OO'i^D 

COMMAND (?): RT 

^ WARNING: TO ENSURE PROPER ^ 

^ DISK CONTENTS, THE SYSTEM ii 

^ SHOULD BE INACTIVE WHILE ^ 

^ RUNNING THIS UTILITY ^ 



SOURCE (NAME, VOLUME) : 
TARGET (NAME, VOLUME) : 
DEVICE RESTORE? Y 
ARE ALL FARMS CORRECT? 



X, TAPEOl 
$$EDXVOL,EDX002 

(Y,N) : Y 



USE ATTN/CA TO CANCEL THE RESTORE 

DISK RESTORED 
COMMAND (?): 






.^ 
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I Restore Disk Device from More than One Tape 



STAPEUTl 



£^^ 



COMMAND (?): RT 

^ NARNING: TO ENSURE PROPER x 

^ DISK CONTENTS, THE SYSTEM ^ 

* SHOULD BE INACTIVE WHILE ^ 

^ RUNNING THIS UTILITY * 

SOURCE (NAME, VOLUME) : SAVE1,TAPE02 

TARGET (NAME, VOLUME) J $$EDXVOLi EDX002 
DEVICE RESTORE? Y 

ARE ALL PARMS CORRECT? (Y,N): Y 

USE ATTN/CA TO CANCEL THE RESTORE 

MOUNT SAVE2,TAPE02 

REPLY Y WHEN TAPE MOUNTED AND VARIED ONLINE? 

> SVARYON <»D 

TAPE02 ONLINE 

? Y 

DISK RESTORED 

COMMAND (?): 
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ST - Save «> Disk Device or Disk Volume on Tape 

ST saves an entire disk device or a single disk volume on a 
tape. ST prompts you to specify whether you are saving a device 
or volume. The ST command can be used in conjunction with the 
restore command (RT) to backup data you wish to protect. 

Examples 

Save Disk Volume on Tape 



^ 

,/ 



> $VARYON ^C 

TAPEOl ONLINE 

> $L $TAPEUT1 

$TAPEUT1 19P, 00:06:26, LP= 7A00 
TAPEOl DUAL NL 1600 ONLINE 

DEVICE ADDRESS = 00<^C 
TAPE02 SL 1600 OFFLINE 

DEVICE ADDRESS = 00<^D 

COMMAND (?): ST 

J^ WARNING: TO ENSURE PROPER ^ 

^ TAPE CONTENTS, THE SYSTEM ^ 

^ SHOULD BE INACTIVE WHILE ^ 

^ RUNNING THIS UTILITY. ^ 

SOURCE (NAME, VOLUME) : $$EDXVOLf ASMLIB 

TARGET (NAME, VOLUME) : X, TAPEOl 

DEVICE SAVE? N 

VOLUME SAVE OF ASMLIB ONTO TAPE X, TAPEOl 

OK? (Y,N) : Y 

USE ATTN/CA TO CANCEL THE SAVE 

VOLUME SAVED 
COMMAND (?): 
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I Save Disk Device on Tape 



> $VARYON ^C 
TAPEOl ONLINE 

> $L $TAPEUT1 

$TAPEUT1 19P, 00:02:16, LP= 7A00 
TAPEOl DUAL NL 1600 ONLINE 

DEVICE ADDRESS = 004C 
TAPE02 SL 1600 OFFLINE 

DEVICE ADDRESS = 004D 

COMMAND (?): ST 

* WARNING: TO ENSURE PROPER ^ 
^ TAPE CONTENTS, THE SYSTEM ^ 

* SHOULD BE INACTIVE NHILE ^ 
^ RUNNING THIS UTILITY. ^ 

SOURCE (NAME, VOLUME) : $$EDXVOL, EDX002 

TARGET (NAME, VOLUME) : X, TAPEOl 

DEVICE SAVE? Y 

DEVICE SAVE OF DISK CONTAINING EDX002 

ONTO TAPE X, TAPEOl 

OK? (Y,N): Y 

USE ATTN/CA TO CANCEL THE SAVE 

DISK SAVED 
COMMAND (?): 
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Save Disk Device on More than One Tape 



COMMAND (?): ST 

^ warning: to ENSURE PROPER ^ 

^ TAPE CONTENTS, THE SYSTEM ^ 

^ SHOULD BE INACTIVE WHILE ^ 

^ RUNNING THIS UTILITY. ^ 



$$EDXVOL,EDX002 
SAVE1>TAPE01 



EDX002 



SOURCE (NAME, VOLUME) 

TARGET (NAME, VOLUME) 

DEVICE SAVE? Y 

DEVICE SAVE OF DISK CONTAINING 

ONTO TAPE SAVE1,TAPE01 

OK? (Y,N): Y 

USE ATTN/CA TO CANCEL THE SAVE 

END OF TAPE ENCOUNTERED. CONTINUE? Y 
ENTER NEXT TAPE ( NAME , VOLUME ) : SAVE1,TAPE01 
REPLY Y WHEN TAPE SAVE2,TAPE01 IS MOUNTED 
AND VARIED ONLINE? 
> $VARYOH ^C 
TAPEOl ONLINE 
? Y 

DISK SAVED 
COMMAND (?): 






o 
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TA - Allocate a Tape Data Set 

TA deletes an existing data set and reallocates a null data 
set* or adds a null data set after the last data set on the vol- 
ume . 



j Notes i 



3. 



^. 



This command is used to place data set labels on previously 
initialized standard labeled (SL) tapesj the tape unit 
must be in the standard label processing mode. 

All the data on the tape following the newly allocated data 
set i s destroyed . 

The tape must be varied online to the file number of the 
data set being allocated. 

To be accessed by a program* the tape must be varied 
online. 






I Example 

I Allocate Data Set (DATA2222) on Volume IZS'^SS 



COMMAND C?): TA 








TAPEDS (NAME, VOLUME): 


DATA2222, 


123^56 


EXPIRATION DATA (YYDDD): 


79001 




DATA SET ALLOCATED 








COMMAND (?): 
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$TERMUT1 - CHANGE TERMINAL PARAMETERS 



o 



$TERMUT1» a general purpose terminal utility program^ alters 
logical device names* address assignments or terminal config- 
uration parameters. Changes remain in effect until the next 
IPL. 



$TERMUT1 Commands 



The commands available under $TERMUT1 are listed below. To dis- 
play this list on your terminal* enter a question mark in 
response to the prompting message COMMAND (?)J. 



COMMANDC?): ? 

LA — LIST TERMINAL ASSIGNMENTS 

RE — RENAME 

RA — REASSIGN ADDRESS 

RH — REASSIGN HARDCOPY 

CT — CONFIGURE TERMINAL 

EN — END PROGRAM 

COMMANDC?) : 






After the commands are displayed* you are again prompted with 
COMMAND (?):. You respond with the command of your choice (for 
example* LA ) . 



c 
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CT - Configure Terminal 

CT modifies the page formatting parameters associated with a 
terminal. In the following example^ the conditional prompt 
message associated with each parameter is shown. Default val- 
ues are indicated in parent lieses. 



ENTER TERMINAL 
PAGE SIZE: 2<i 
TOP MARGIN: 12 
BOTTOM MARGIN: 
HISTORY LINES: 
LEFT MARGIN: 
RIGHT MARGIN: 7 
OVERFLOW LINES? 
OUTPUT PAUSE? N 



NAME: 


SSYSLOG 


( load i ng 


terminal) 




( from 


TERMINAL 


statement ) 




(0) 






23 


(page 


s i ze -1 ) 




6 


(0) 
(0) 






9 


(line 


s i ze -1 ) 




N 


(N) 
(N) 










The option OUTPUT PAUSE allows the 'screen full' pause for 
screen devices to be disabled so that unattended systems do not 
enter an indefinite wait state. 

Note : For more information on terminal parameters^ see the 
TERMINAL statement in the System Gui de ♦ 



EN - End Program 

EN terminates the $TERMUT1 utility. 
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LA ~ List Terminal Assignments 

LA lists the current terminal names* addresses and types 



COMMANDC?): LA 

NAME ADDRESS 

$SYSLOG 0<* 
$SYSPRTR 01 
$SYSLOGA 00 
06 
DISPLAY2 07 

COMMANDC ?) : 



TYPE 

^979 

TTY 

-^979 

^978 



No name appears for the device at address 06 because there was 
none on the original TERMINAL statement. 



RA - Reassign Address 

RA reassigns the physical address of a terminal specified in 
the address= parameter of the TERMINAL statement during system 
generation The form for this function is: 



iV 




where the address in question must be currently unassigned 
Some examples are: 



RA 
RA 
RA 


DISPLAY2 7 
SSYSPRTR 12 
(05) 06 



o 
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RE - Rename Logical Device 



RE renames the logical terminal name (the label on the TERMINAL 
statement) that you specified during system generation. The 
form for this function \s* 



RE oldname neMname 



The new name replaces the old name. As shown in the following 
examples* the old name can be a logical name or a hexadecimal 
device address. If a device address is indicated* it must con- 
sist of 1 or 2 digits enclosed in parentheses. 



RE DISPLAY2 DISPLAYS 
RE (06) TERMl 



.y 



The changes are verified by entering the LA command. 
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RH changes the hardcopy device associated with a A979/^9 78 dis- 
play* and indicates which program function key will produce the 
hardcopy. The form is: 



RH name keycode 



Here 'name' is the logical name (not device address) of the 
hardcopy device* and 'keycode' is the code for the desired 
hardcopy key (e.g.» 1 to 6 for the 4979 display). 

The hardcopy device is changed for the terminal from which 
$TERMUT1 was loaded. Some examples are: 



RH $SYSLOGA 6 
RH $SYSLOGA <» 
RH PRTR2 6 
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I $TERMUT2 - PROCESS ^97^/<i97B IMAGE/CONTROL STORE 



$TERMUT2 is used to: 



Assign a DEFINE key in a <^978 control store. 



• Change the definition of one or more keys in a ^978 control 
store . 

• Load a ^978 control store from a direct access data set 
or saving a newly redefined 4978 control store into a 
direct access data set. The control store is a data set 
containing the 4978 control store and microcode to access 
the image store. 

• Load a 4978 image store from a direct access data set or 
save a 4978 image store into a direct access data set. (Re- 
fer to the description of the $FONT utility program for a 
description of image store definition.) 

• Restore tlie image buffer of a 4974 printer to the standard 
64 character set . 

You may wish to invoke these functions from a terminal other 
than the one you are using; therefore? you are requested to 
specify a terminal. If the selected terminal is not a 4978» you 
are notified and the command is rejected. 



4978 Support 



Use $TERMUT2 to to make special character string assignments on 
the 4978 keyboard. Key definitions can be changed? perhaps to 
be appropriate to a special key data application? and the rede- 
fined keyboard definitions saved on disk. The keyboard defi- 
nition can be reloaded later using $TERMUT2 or by using the 
TERMCTRL instruction within your application. 4096 bytes are 
transferred during an image control save so a 16 record data 
set must be defined for each control store image to be stored. 
Use $FONT to change the display image of redefined keys. For 
detailed information on the 4978 display station functions and 
the 4978 keyboards? refer to the Bibliography for 4978-1 Dis- 
play Station manuals. 
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Use $TERMUT2 to restore the image buffer of a 4974 printer to 
the standard 64 character set. The 4974 printer uses the 
Extended Binary Coded Decimal Interchange Code (EBCDIC)* which 
includes 64 standard characters and five characters for inter- 
national use. The standard key definition canbe changed by 
using the TERMCTRL instruction within your application program 
and the redefined character set is stored in the image buffer 
of the 4974. For detailed information on the 4974 printer, 
refer to the Bibliography for the 4974 Printer manual. 



Data Set Names 



Naming conventions for image store and control store data sets 
follow the conventions of the Event Driven Executive: the label 
can be up to eight characters. Two special names are reserved 
by the system and used during initial program load time: 



$4978150 - image store label 
$4978CS0 - control store label 



\.-.^ 



These data sets are automatically searched for and loaded to 
defined 4978 display stations during the initialization phase 
at IPL t ime . 



$TERMUT2 Commands 



The commands available under $TERMUT2 are listed below. To dis- 
play this list at your terminal, enter a question mark in 
response to the prompting message COMMAND (?):. 
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COMMAND (?): ? 

AD - ASSIGN DEFINE KEY 

C - CHANGE KEY DEFINITION 

EN - END PROGRAM 

LC - LOAD CONTROL STORE 

LI ~ LOAD IMAGE STORE 

RE - RESTORE ^974 TO STD. 64 CHAR. SET 

SC - SAVE CONTROL STORE 

SI - SAVE IMAGE STORE 

COMMAND (?): 



After the commands are displayed^ you are agi^in prompted with 
COMMAND (?):. You respond with the command of your choice (for 
example » AD) . 



.y 



Chapter 4. The Utilities 



341 



$TERMUT2 

Examples 

AD -- Assign a Define Kev 



COMMAND (?): AD 

ENTER SCAN CODE OF KEY TO BE 

AS THE DEFINE KEY (HEX): 1 

ENTER TERMINAL NAME (CR OR >f 



ASSIGNED 



- THIS ONE) : $SYSUOG 



Change a Kev Definition 



COMMAND (?): C 

ENTER TERMINAL NAME (CR OR ^ = THIS ONE): $SYSLOG 

ENTER SCAN CODE OF THE KEY TO BE REDEFINED (HEX): 1 

ENTER NEW FUNCTION ID (HEX): 20 

ENTER NEW CHARACTER/FUNCTION CODE (HEX): 

ENTER NEW INTERRUPT CODE (HEX): 1 

ANOTHER KEY? N 



\...J>^ 



LC - Load a Control Store 



COMMAND (?): LC 

FROM DATA SET ( NAME , VOLUME ) : 
ENTER TERMINAL NAME (CR OR ^ 



$'^978030 

= THIS ONE) 
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I RE - Restore 497*^ to Standard 6<» Character Set 






o 



COMMAND (?): RE 

ENTER TERMINAL NAME (CR OR ^ = THIS ONE): MPRINTER 



SC - Save a Control Store 



COMMAND (?): SC 

SAVE DATA SET (NAME , VOLUME ) : $^978CS0 

ENTER TERMINAL NAME (CR OR ^ = THIS ONE): $SYSLOG 
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$TERMUT3 - SEND MESSAGE TO A TERMINAL 



$TERMUT3 sends a single line message from your terminal to any 
other terminal defined in the system. One message line is sent 
at a time and you are prompted for the message* the terminal the 
message is to be send to f and if additional messages are to be 
sent. There are no commands, only prompting messages as fol- 
lows * 



ENTER TERMINAL NAME: 

Label of the terminal to which message is to go. 

ENTER MESSAGE TO SEND 

Type in message and press the ENTER CCR) key. 

The message is transmitted to the destination terminal. 

ANOTHER LINE? 

Yes or No. 

If yes, you are prompted to enter another message line. 

ANOTHER TERMINAL? 

Yes or No. If yes, select another terminal and 

repeat the above process. 

SEND MESSAGE LATER (*ATTN SEND*)? 
Yes or No. If yes, the program remains loaded 
and inactive. Pressing the ATTN key and 
entering *SEND* starts the above process again. 
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Examples 

S end a Message to Terminal ^SYSLOGA 



$TERMUT3 3P,00:'^l:10, LP= 8800 

TERMINAL BROADCAST PROGRAM 

ENTER TERMINAL NAME: $SYSLOGA 
ENTER MESSAGE TO SEND 
THIS IS A TEST MESSAGE. 

ANOTHER MESSAGE ? Y 

ENTER MESSAGE TO SEND 

THIS IS ANOTHER TEST MESSAGE. 

ANOTHER MESSAGE ? N 

ANOTHER TERMINAL ? N 

DETACH PGM (NAIT FOR *ATTN SEND") ? N 

$TERMUT3 ENDED AT 00:^3505 
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Select Another Terminal After Sendin g a Message 



ANOTHER LINE ? N 

ANOTHER TERMINAL ? Y 

ENTER TERMINAL NAME: $SYSPRTR 

ENTER MESSAGE TO SEND 

HELLO $SYSPRTR 

ANOTHER LINE ? N 

ANOTHER TERMINAL ? N 

SEND MESSAGE LATER ('ATTN SEND') ? N 

$TERMUT3 ENDED AT 00:5'!^^:00 



U J 
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Keep $TERMUT3 Active* Send a Message Later 



ANOTHER LINE ? N 

ANOTHER TERMINAL ? N 

SEND MESSAGE LATER ('ATTN SEND») ? Y 

> SEND 

ENTER TERMINAL NAME: TTY30 
ENTER MESSAGE TO SEND 
TTY30 - ARE YOU THERE 

ANOTHER LINE ? N 

ANOTHER TERMINAL ? N 

SEND MESSAGE LATER ('ATTN SEND') ? N 

$TERMUT3 ENDED AT 01:^2:15 
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STRAP - SAVE STORAGE ON ERROR CONDITION 



$TRAP intercepts certain class interrupts and saves the con*- 
tents'of hardware registers and processor storage on a disk Or 
diskette data set. This utility helps you to diagnose system or 
application proQram problems. The companion utility* $DUMP» 
prepares a formatted display of the data saved by $TRAP. 

$TRAP must be executed before an expected failure so that the 
requested class interrupts can be intercepted when they occur. 
It can also be activated if a class interrupt such as a program 
check or machine check do not occur. 

Two methods are provided to accomplished forced traps? 

• ATTN: TRAPDUMP 

• Tlie console interrupt button 

$TRAP does not affect the execution of any program or operator 
command unless it is activated by a class interrupt such as a 
program check or a machine check* or by the operator. 



% y 
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Example 



"% 



> SL $TRAP 

DUMPDSCNAME, VOLUME) : DUMP,EDX003 
OTRAP 15P, IZaet'iiZ, LP8F00 



Notes 
(1) 



^-^ NARNING 

TO ACTIVATE T 
TO DEACTIVATE 
TO FORCE TRAP 
TO END $TRAP 
DO NOT USE $C 
IF TRAP OCCUR 
TRAP ON MACHI 
TRAP ON PROGR 
SPECIFICATION 
INVALID STORA 
PRIVILEGE VIO 
PROTECT CHECK 
INVALID FUNCT 
TRAP ON SOFT 
INVALID FUNCT 
FLOATING POIN 
STACK EXCEPTI 
TRAP ON CONSO 
SAVE FLOATING 



¥:-^-^-^ 



EARNING 



^-9«-^-^ 



NARNING 



¥:~^ 



RAP USE ATTN 

TRAP USE ATTN 

USE ATTN 
USE ATTN 

TO END $TRAP 
S SYSTEM MUST BE 
NE CHECK? (Y/N) Y 
AM CHECK? (Y/N) Y 

CHECK? (Y/N) Y 
GE ADDRESS? (Y/N) Y 
LATE? (Y/N) Y 
? (Y/N) Y 
ION? (Y/N) Y 
EXCEPTION? (Y/N) Y 
ION? (Y/N) Y 
T EXCEPTION? (Y/N) Y 
ON? (Y/N) Y 
LE INTERRUPT? (Y/N) Y 

POINT REGS? (Y/N) Y 



TRAPON 
TRAPOFF 
TRAPDUMP 
TRAPEND 

IPLED 



TRAP SET OFF 

READY FOR ATTN: X X 

> TRAPON 
TRAP SET ON 

> TRAPOFF 
TRAP SET OFF 



(2) 
(2) 
(2) 
(3) 
C3) 
(^) 
(5) 
(6) 



(7) 



(8) 


(9) 


(10) 


(11) 


(11) 



Notes : 

1. The $TRAP data set must be as large as the storage used: for 
a 6^K-byte system^ It must be at least 256 records; for a 
128K-byte system at least 512 records. 



2. Trap initiation is via the attention handler. TRAPON acti- 
vates the trap facility but does not produce a storage 
dump. You must activate the trap facility (TRAPON) first; 
then specify TRAPDUMP to force a storage dump. If TRAPDUMP 
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is usedt IPL to resume operations. 

3. $TRAP should not be cancelled using $C. Use TRAPEND. 

<+. During trap process in g» all I/O activities are halted. All 
configured devices are reset. IPL to resume operations. 

5. A 'Y* response saves storage and hardware registers when 
any machine check (storage parity, CPU control or I/O error 
check)occurs. 

6. A *Y* response prompts you for the type of program cfieck to 
trap. Any combination of the five types can be selected. 

7. A 'Y' response prompts you for the type of soft exception 
to trap. Any combination can be selected. 

8. It may be desirable to save storage even though no hardware 
detectable error has occurred. This option can be used to 
cause a trap when the console interrupt button is pressed. 
(Programmer console must be installed on Series/1) 

9. Respond with 'Y* if the Series/1 has the floating point 
hardware installed, 

10. $TRAP initializes to a TRAPOFF state. Any time after this 
message you can activate trap using the $TRAP attention 
commands. See notes 2-4. 






11. These are the TRAPON and TRAPOFF attention commands. 
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CHAPTER 5. APPLICATION PROGRAM PREPARATION 



Application program preparation consists of four major oper- 
at i ons J 

1. Entering the program source statements onto disk or 
d i skette . 

2. Compiling or assembling the source program into an object 
module . 

3. Link editing two or more object modules together to form 
the final object module. 

^. Converting the object module into an executable relocata- 
ble load module which can then be loaded and executed. 



Entering Source Statements 



jr*\ 



Entering program source statements for assembly or compilation 
on the Series/1 is normally performed using either of the edi- 
tor utilities* $EDIT1N or $FSEDIT. (For descriptions of the 
text editors* refer to "Chapter ^ . The Utilities" on page ^7. 



Nhen entering source programs which will be assembled by the 
System/ 370 host assembler* $EDIT1 or $FSEDIT can be used to 
enter the program and store it in a host data set. This oper- 
ation requires that lUP 5796~PGH* Event Driven Executive Host 
Communication Facility* be installed on the host computer. 
Alternatively* a source program entered using $EDIT1N or 
$FSEDIT can be transmitted to the host for assembly using util- 
ity programs $RJE2780 or $RJE3780 when the host computer sup- 
ports the IBM 2780 or 3780 RJE stations. 

Programs to be assembled on the host System/370 can also be 
entered into the System/ 370 as either punched card decks or by 
any type of terminal input supported by the host system. 
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Program Assembly/Compilation 



Program assembly or compilation can be performed by several 
assemblers and compilers each with some restrictions on their 
capabilities. They include: 



The Event Driven Language compiler, $EDXASM, from 
Event Driven Executive Program Preparation Facility 



the 



The Series/l Macro Assembler ($S1ASM) 

The Macro Assembler supplied by the System/370 Program 
Preparation Facility 

The COBOL compi ler 

The FORTRAN compi ler 



The PL/I comp i ler 



Some restrictions that apply to the use of the tuo assembler 
programs ($S1ASM and Host Preparation) and the $EDXASM compil- 
er are discussed in more detail in the chapters on each of them. 
The $EDXASM compiler and the $S1ASM assembler can be executed 
concurrently with other programs in an Event Driven Executive 
based system. Both the 5eries/l and Host assemblers are macro 
assemblers which permit the assembly of both Event Driven 
Language instructions and Series/1 assembler language 
instructions. $EDXASM provides for the compilation of Event 
Driven Language instructions only. Use of the host assembler 
requires installation of tiie Event Driven Executive Macro 
Library/Host. Assembly of Series/1 assembler instructions and 
Event Driven Language instructions using $S1ASM requires the 
Event Driven Executive Macro Library. 

Object modules produced by the host assembler must be transmit- 
ted to Series/1 disk or diskette for link editing and conver- 
sion into executable programs. Possible means of transmission 
include the useof utility programs $HCFUri» $RJE2780, or 
$RJE3780. If the host assembly is a complete main program, it 
can be transmitted and converted in one step by using the util- 
ity program $UPDATEH. Use of $HCFUT1 or $UPDATEH requires that 
the Host Communications Facility (lUP 5796-PGH) be installed 
on the host computer. 



/f"'"~■^ 



Minor differences exist between the format of source programs 
to be compiled by $EDXASM and either of the macro assemblers. 
When using $EDXASM» you must explicitly code any ECB and QCB 
statements that are required. Also, $EDXASM provides the COPY 
statement function in a different manner than the host assem- 
bler, or the limited manner available with the Event Driven 
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Executive Macro Library as a macro instruction. $EDXASM per 
mits labels in programs to be composed of any printaole charac 
ters with a maximum label length of eight characters. 



Linkage Editor 






Link editing object modules together is an optional program 
preparation step except when the Series/l Macro Assembler 
($S1ASM) is used. In that case* the output object module of 
$S1A5M must always be link edited ($LINK). If your program is 
compiled or assembled as a single module it is not necessary to 
use the linkage editor, $LINK, in the program preparation proc- 
ess (except when $S1ASM is used). However, when creating large 
programs it is frequently desirable to segment the program into 
functional modules. The modules can then be compiled or assem- 
bled separately, as they are created, and then linked together 
to form the final program. In this manner, a change in one mod- 
ule requires only recompiling or reassembling the modified 
section followed by a link editing with the unchanged modules. 
Object modules that are input to $LINK can be created by 
$EDXA5M, $S1ASM, COBOL, FORTRAN, PL/I, or the Host Assembler as 
previously described. 



Object Module Conversion 



The program modules which are the output of the various compil- 
er or assembler programs or $LINK are not in the format that is 
required by the program loading function of the system supervi- 
sor. The utility programs $UPDATE or $UPDATEH must be used to 
convert an object module into loadable form and to update the 
directory of the volume on which the loadable program is 
stored. 



Prefind of Data Sets and Overlays 



Each time your program is loaded into storage for execution, 
the location of the data sets and overlays it uses must be 
determined by the loader. $PREFIND can be used to perform the 
data set and overlay location function before program load 
time. The result is a faster load operation. Use of $PREFIND is 
opt i ona 1 . 
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Caution must be exercised in using $PREFIND. See "$PREFIND 
Usage Cautions" on page 303. 



Summary 



The following sections describe in more detail the use of the 
various assemblers and compilers and the operation of $LINK, 
$UPDATE, $UPDATEH, and $PREFIND. See "Chapter 4. The 
Utilities" on page 47 for descriptions of the editing utilities 
$EDIT1, $EDIT1N, and $FSEDIT (they are not used exclusively for 
source program entry). 

The programs $EDXASM, $LINK, $PREFIND, $UPDATE, and $UPDATEH 
can be invoked individually from a terminal using either the 
session manager or the $L function. They can also be invoked as 
part of a batcti job stream operation under the control of 
$JOBUTIL utility. For a description of $JOBUTIL operations* 
see "$JOBUTIL - Job Stream Processor" on page 271. 

Figure 22 on page 355 shows the program preparation process of 
assembling or compiling, link editing and updating. The pro- 
grams can be invoked individually by the session manager or 
through the batch job stream processing utility. An example of 
preparing an application program can be found in the System 
Guide. 
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Figure 22. Event Driven Executive program preparation 
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SEDXASM - EVENT DRIVEN LANGUAGE COMPILER 






$EDXASM provides an online program compilation capability that 
can be executed concurrently with other programs in an Event 
Driven Executive based system. Multiple copies of $EDXASM can 
operate concurrently. 

$EDXASM is composed of a main program plus a large number of 
overlay programs and* therefore* makes extensive use of the 
program loading facilities of the supervisor. If during exe- 
cution of $EDXASM» you invoke other programs by means of the $L 
function, the execution of $EDXASM may be delayed until all 
information needed by the $L command (e.g. data set names) has 
been entered. This delay is because the program load facility 
is a serially usable function and must complete one program 
load request before starting another. It is good practice to 
enter as much of the required information as possible on the 
same line of input as the $L command to minimize the time that 
the loader is busy. 

Example 



> $L PROGRAM>VOLUME DATASETl, VOLUME DATASET2, VOLUME 

Note * Volume parameters are optional if the IPL volume 
i s used . 



V-.y 



The description of $EDXASM assumes that you have already 

entered the source program to be compiled into a disk or 

diskette data set by means of one of the editor utilities, 
$EDIT1N or $FSEDIT. 

$EDXASM can be invoked either by the $L command, by the 
$JOBUTIL utility, or by the program preparation utilities 
option selection menu operating under the Session Manager. In 
each case, the same information must be provided when $EDXASM 
is loaded for execution. Invoking $EDXASM using $JOBUTIL is 
shown under "Invoking $EDXASM Using $JOBUTIL" on page 368. 
Invoking $EDXASM using the Session Manager is shown under 
"Invoking $EDXASM Using the Session Manager" on page 369. 
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Language Control Data Set 



$EDXASM uses a language control data set» $EDXL. The data set 
IS divided into two logical parts: the error messages and the 
operation codes to process module specifications. This data 
set is produced by $EDIT1N. As distributed* $EDXL in the volume 
ASMLIB contains the standard compiler error messages and Event 
Driven Language instruction set specifications. You may wish 
to add COPY code definitions or additional processing modules 
and error messages and may even desire to have differently 
modified versions assigned to different users. The contents of 
$EDXL are described in the Internal Design . The use of the 
^COPYCOD function within $EDXL is described under "COPY 
Statements" on page 362. 



Required Data Sets 



$EDXASM requires three data sets. These data sets* in order of 
specification when $EDXASM is invoked using $L are: 

1 • The input* or source* data set. The format of this data set 
is the same as produced by $EDIT1N/$FSEDIT , 

2 . The w ork data s et. This data set contains object code* 
relocation pointers and the symbol table. A minimum size 
of 100 records is recommended; 250 records might be consid- 
ered average and 500 records would be large. This data set 
is automatically allocated by the Session Manager to be ^00 
records . 

3 . The o bje c t data set. This data set contains the output 
object module from the compilation and serves as input to 
$UPDATE (or to $LINK* if a link edit is required). The 
appropriate size for the object module data set is also 
dependent on the program size. For estimating purposes* 
divide the program length in bytes by 100 to get the number 
of records required. 
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Sample printouts showing the prompt messages and replies fol 
low : 



\„,.i^ 



> $L $EDXASM,ASMLIB 
SOURCE (NAME, VOLUME) 
WOR KF I LE( NAME, VOLUME) 
OBJECT (NAME, VOLUME) 

$EDXASM 64P, 02:48 

SELECT OPTIONS (?) : ? 



ASMSRC 
ASMWORK 
ASMOBJ 
50, LP= 6300 



The program name and data sets required can be entered in the 
same line. For example? 



> $L $EDXASM,ASMLIB ASMSRC ASMWORK ASMOBJ 



This single line entry is equivalent to the multiline entries 
above . 






Compiler Options 



When the compiler is loaded into storage, enter the options to 
be used. The option list follows: 



SELECT OPTIONS (?): ? 

LIST - SPECIFY LIST DEVICE 
NOLIST - DO NOT PRINT LISTING 
ERRORS - LIST ERRORS ONLY 
CONTROL - SPECIFY CONTROL LANGUAGE 
END - END OPTION SELECTION 
('ATTN - CA' TO CANCEL ASSEMBLY) 



o 
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If no options are selected* because you entered only a carriage 
return/ENTER in response to the select option message, the 
defaults are LIST on $5YSPRTR using the language control data 
set $EDXL on the volume ASMLIB. If a listing is required on 
another device* specify LIST or L. You can enter the name of 
the device in response to the prompt for device name or on the 
same line. A null entry or an * is used to specify your termi- 
na 1 . 

If no listing is required, specify NOLIST or N . . .I-n this case, 
the compile statistics are printed on the same,, terminal as 
$EDXASM was loaded from. If only statements containing errors 
are to be printed, specify ERRORS or ER. In this case, a device 
name is required as in LIST. Similarly, a null entry or aster- 
isk (^) indicates that the error messages are to be listed on 
the loading terminal. This option is very useful for the first 
few compilations to remove typographical or simple syntactical 
errors from the source program. 

If a control data set other than $EDXL on the volume ASMLIB is 
required, enter CONTROL followed by the name and volume of the 
data set to be used. All option entries can be entered on a 
single line or in response to prompt messages. The last 
entered listing option takes precedence. The compilation or 
the subsequent listing can be cancelled at any time by pressing 
ATTN and entering CA. 



$EDXASri Output 



When the compilation process is complete, the compiler prints 
out statistics. They indicate the source, work, and object data 
sets used, the date and time the compilation started, the 
elapsed time for the compilation, the number of statements 
processed, the number of statements flagged with error mes- 
sages, and the compilation completion code. A completion code 
of -1 is normal. At this time, the object module is stored and 
is ready for input to $ UPDATE or $LINK. If a listing has been 
requested, it is then printed on the appropriate output device. 
The printing of duplicate lines of object code is automatically 
suppressed by the listing routine of $EDXASN. Before the data 
sets specified in the compilation are reused, it is possible to 
request a listing of the compilation using the program 
$EDXLIST. Refer to "$EDXLIST - Compiler Listing Program" on 
page 370 for more information. 
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Examples 



LIST on $SYSPRTR: 

SELECT OPTIONS (?): null entry 



ERRORS on PRINTERl: 

SELECT OPTIONS (?): ERRORS 

DEVICE NAME: PRINTERl 
SELECT OPTIONS: END 

or 
SELECT OPTIONS: ER PRINTERl END 



NOLIST and use $EDXL on EDX002: 

SELECT OPTIONS (?): N CONTROL 
CONTROL (NAME, VOLUME) : $EDXL,EDX002 
SELECT OPTIONS (?): END 






Processing Co mpiler Ou tput with ^UPDATE or $LINK 



The output object module has been completed before the listing 
is started; therefore, the object module can be processed by 
$LINK and /or $UPDATE while tlie listing is being produced. The 
operation of $UPDATE is described under "$UPDATE - Object 
Program Converter" on page -^OS. The operation of $LINK is 
described under "$LINK - Linkage Editor" on page 390. 



o 
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Compiler Features Supported 



Print Control Supported: 

EJECT 

SPACE 

SPACE n 1 < n < 25 

PRINT OFF/ON 

PRINT DATA/NODATA 

PRINT NODATA suppresses the printing of all 

lines of object code which are not on the same 
line as a source statement. 

PRINT DATA is equivalent to PRINT ON. 



Print Control Unsupported: 

TITLE 

PRINT GEN/NOGEN 



Establishing Symbolic Representation 

EQU 

CSECT 

ENTRY 

EXTRN 

WXTRN 



Programim'ng Considerations 



Source Line Continuation 



Continuation of source lines is indicated by placing any char- 
acter in position 72 of the line to be continued. If the line to 
be continued contains a blank prior to position 71, then any 
further information on that line is ignored. Continuation 
lines must begin in position 16. The data in positions 16 up to 
71 (or the first blank) i^ concatenated to the data from the 
preced i ng line. 
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Recommended practice is to either code the operand fields 
through position 71 of a line to be continued* or to terminate 
the line by placing a blank after the comma which terminates 
one operand in the string of operands. 



o 



The maximum number of continuation lines is limited only by the 
maximum of 254 characters in the operand field. 



COPY Statements 



COPY statements can only be used in the first level of source 
code. They cannot be used within COPY code. 

§EDXL contains two ^COPYCOD statements, ^COPYCOD ASMLIB and 
^COPYCOD EDX002. This indicates to $EDXASM that volumes ASMLIB 
and EDX002 are to be searched for the special source module 
each time a COPY statement appears in a source program. If your 
COPY modules are not in either of the above volumes, you must 
add an ^COPYCOD statement to $EDXL for each additional volume 
wliich contains COPY modules. 

To define your COPY code to the compiler: 

1. Create your COPY code source statements by using $EDIT1N or 
$FSEDIT 



,jr 



2. Add ^COPYCOD statements (if required) to $EDXL (or your 
$EDXL special copy), with $EDIT1N or $FSEDIT. 

The format of the ^COPYCOD statements is: 



Column 



^fCOPYCOD volume 
1 10 



The libraries btg searched in the order in which the J^COPYCOD 
statements appear in $EDXL. 



ECB and QCB 



Certain conditions apply when any of the following are coded 



^iii.jj^'' 
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LOAD . . . ,EVENT=ecbname 
WAIT/POST ecbname 
ENQ/DEQ qcbname 



The ECB or QCB is not automatically created but must be explic- 
itly specified by you. If EVENT=ecbname is specified in a PRO- 
GRAM or TASK statement* do not code an ECB statement; 
otherwise* duplicate labels will result. 



Multiple Declarations on DC and DATA statements 



Nhen implementing DC (or DATA) statements* up to 10 declara- 
tions can be made on a single DC statement. A sample statement 
f ol lows : 



y 



DC F'5' ,A(TEST),CL5»ABC' 



The following DC types are supported: 
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F'x'>niF*x* where 'm' is the number of times the 

data is to be duplicated 
A(y)>mA(y) 

X'zNmX'z* where 'z* can be from 1-8 hexadecimal 

digits. 
H»s',mH's' 

C't» ,mC't' ,CLn't' ,mCLn't' 

where ' n * is the length of the data 

in bytes 
D'w' ,mD'w' 

E*u' ,mE'u' 

L' V ,mL'v' 



lODEF Statement Placement 



lODEF statements must appear after the PROGRAM statement and 
before the ENDPROG statement. Also, all lODEF statements of 
the same type (e.g.» PI, DI» DO, AX, AO) must appear together in 
a group. For example, if a program requires two DI and three DO 
definitions, the statements in the program would be coded as 
follows: 






lODEF 
lODEF 
lODEF 
lODEF 
lODEF 



DIl, . 
DI2, , 
DOl , . 
D02, . 
D03, . 



In other words, 
together. 



the DI and DO definitions must be grouped 
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6ETEDIT and PUTEDIT 



The instructions GETEDIT and PUTEDIT cannot have the format 
statement included in the instruction, A separately coded FOR- 
MAT statement must be referenced by the GETEDIT or PUTEDIT 
i nstr uct i on . 



ATTNLIST Statement 



The ATTNLIST statement can have only one list coded. The list 
can be up to 254 characters in length and can contain a total of 
50 suboperands or 25 ATTNLIST entries. 



EQU Statement 



Labels referenced in EQU statements must have been previously 
defined. 



Arithmetic Expression Operators 



Only one operator is allowed in an arithmetic expression. Val- 
id operators are +> -» ^» and /. For example, the following 
expressions are valid: A + B» C-l» D^<^, E/2. If an expression 
containing more than one term is required, multiple equate 
statements can be coded. For example, to compute the address 
A+B-2, the following statements can be coded: 



APB 
APBM2 



EQU 
EQU 



A + B 
APB-2 



Instructions Requiring Support Modules 



Certain instructions require support modules link edited into 
the executable load module. These modules are referenced in 
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the linkage editor autocall data set $AUTO. Therefore* the mod- 
ules are automatically included in your program by running the 
link editor on the object module output of $EDXASM. Use of the 
following ir^structions requires a link edit. 






Formatting instructions 



GETEDIT 
PUTEDIT 
FORMAT 



Graphics instructions 



CONCAT 


GIN 


PLOTGIN 


SCREEN 


XYPLOT 


YTPLOT 



w 



Square root instruction 




Ser i es/l Ma cro Assembler inte r f a c e in s tr uct i o n 




The supervisor interface module $$RETURN must be 
with any module that includes the USER statement. 



1 i nk~ed i ted 



o 
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A link edit is also required if any of the following screen 
formatting subroutines are called in an application program: 



$IMOPEN 


$IMGEN 


$IMDEFN 


$IMPROT 


$IMDATA 


$PACK 


$UNPACK 



The supervisor interface module $$RETURN must be link-edited 
with $IMOPEN and $IMGEN if they are called in an application 
program . 



•%, 



See the description of "$LINK - Linkage Editor" on page 390 for 
information on using the linkage editor. 
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Invoking SEDXASM 



Invoking $EDXASM Using $JOBUTIL 



$EDXASM can be invoked using $JOBUTIL. The same options are 
available througli the FARM facility of the job s.tream processor 
($JOBUTIL) as were described previously under the $L command. 
The listing option is specified in column 10, the device name 
in column 20, and the control data set name and volume in column 
^0. If the default options are required, the FARM statement can 
be blank but must be included in the procedure. A sample proce- 
dure is shown below: 



LOG 


FRINTERl 


FROGRAM 


$EDXASM,ASMLIB 


DS 


ASMSRC 


DS 


ASMWORK,EDX003 


DS 


ASMOBJ 


FARM 


LIST FRINTERl 


NOMSG 




EXEC 
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Invoking $EDXASN Using the Session Manager 



$EDXASM can be invoked using the session manager by selecting 
option 1 from the program preparation secondary option menu. 

The following parameter selection menu is displayed for entry 
of the required data sets and optional parameters. The control 
data set is assumed to be $EDXL on ASMLIB. The example shows the 
data set ASMSRC is to be compiled with the object output being 
directed to the data set ASMOBJ . 



^•lO.i.'" 



$SMM020l: SESSION MANAGER $EDXASM PARAMETER INPUT MENU - 
ENTER/SELECT PARAMETERS: DEPRESS PF3 TO RETURN 



SOURCE INPUT (NAME, VOLUME) ==> ASMSRC, EDX002 
OBJECT OUTPUT ( NAME , VOLUME ) ==> ASMOBJ, EDX002 

ENTER OPTIONAL PARAMETERS BY POSITION ==> NOLIST 

1 

LIST 

NOLIST 

ERRORS 



LPRINTER 

2 

PRINTER 
NAME 

DEFAULTS ARE: 

LIST 

$SYSPRTR 
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SEDXLIST - Compiler Listing Program 



( 



$EDXLIST is used to obtain a listing of the last $EDXASM compi- 
lation performed. 

You can specify LIST or NOLIST in response to the SELECT 
OPTIONS (?): prompt when $EDXASM is loaded. If you respond with 
the ENTER key or LIST, $EDXASM automatically loads $EDXLIST as 
part of the compilation step and produces a listing of the com- 
pilation. If you respond with NOLIST^ the statistics from the 
compilation are displayed on the loading terminal and a listing 
i s not produced . 

$EDXLIST can be loaded as a separate program. For example, if 
NOLIST were selected, and the statistics displayed at the end 
of the compilation indicate that there are compilation errors, 
$EDXLIST can then be loaded to print a listing, 

$EDXLIST will prompt for the source data set and the work data 
set and will get the name of the language control data set from 
the work data set, in which it is stored, at the end of the com- 
pilation. As long as an intervening compilation has not altered 
the contents of the work data set, and you have not modified the 
source or language control data sets, $EDXLIST will produce the 
same listing when loaded by you after a compilation as it would 
were it loaded by $EDXASM as part of the compilation step. 



'A^ -y 



Invoking $EDXLIST 



$EDXLIST is invoked using $L. Two data set names are required: 
the source (SOURCE) and work (WORKFILE) data set used for com- 
pilation. The name of the control data set used for the compi- 
lation is kept in the work data set. If $EDXASM was invoked by 
the session manager, the work data set will be named $SMluser 
(where user is the sign on ID used). 

Cauti on' If you want a listing of the latest compilation, use 
$EDXLIST before invoking $EDXASM again. Any subsequent compi- 
lation modifies the contents of the source and work data sets. 

An example using $EDXLIST follows: 



o 
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> $L $EDXLIST,ASMLIB 

SOURCE (NAME, VOLUME) 

WOR KF I LE( NAME, VOLUME) 

$EDXLIST 21P, 00:07 



ASMSRC,EDX002 
ASMWORK,EDX002 
^^f LP= 6500 






SELECT OPTIONS (?) : ? 

LIST - SPECIFY LIST DEVICE 
ERRORS - LIST ERRORS ONLY 
END - END OPTION SELECTION 
('ATTN - CA' TO CANCEL LISTING) 

SELECT OPTIONS (?): LIST 
DEVICE name: SSYSPRTR 

SELECT OPTIONS (?) : END 

$EDXLIST ENDED AT 00:08:'^6 
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SSIASM - SERIES/X ASSEMBLER 



$S1ASM provides an online program assembly capability that can 
be executed concurrently with other programs in an Event Driven 
Executive system. $S1ASM produces object modules from source 
programs written in Series/1 assembler language or Series/1 
assembler language macros such as the commands provided by the 
Event Driven Executive Macro Library, Multiple copies of 
$S1ASM can operate concurrently if each copy has its own work 
files and printer. $S1ASM is composed of a main program and a 
number of overlays. 

The following description of $51ASM assumes that you have 
entered the source program to be assembled into a disk or 
diskette data set. This is accomplished by using one of the 
editor utility programs, $EDIT1N or $FSEDIT. $S1ASM can be 
i nvoked by : 

• The Program Preparation utilities option selection menu 
operating under the session manager 

• The $L operator command 

• The batch job stream processing utility, $JOBUTIL. 



Required Data Sets 



$L and §JOBUTIL require that the following information be pro- 
vided when $S1ASM is loaded for execution, 

1. The source input data set. 

2. Three work data sets, used as work files, containing object 
code, relocation pointers, the symbol table, and other 
information. For most programs, sizes of 2000, 2000, and 
800 for ASMWRKl, ASMWRK2, and ASMWRK3, respectively, are 
sufficient. This requirement can increase when assembling 
a large program containing many macro calls. 

3. The object data set. This data set will contain the output 
object module. It serves as input to the linkage editor 
($LINK) which must always be run when using $S1ASM. A size 
of 50 to 100 sectors is sufficient for most programs. 

The Session Manager provides the work data sets and 
requires only that the input and output data sets be speci- 
fied. 



\.-J 
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Invoking $S1ASM 



Invoking $S1ASM using $L 



or illustrative purposes^ let us assume that: 

EDX002 is the IPL volume 

Data sets ASMSRC and ASMOBJ are on that volume 

EDX003 contains the ASMWORKl, ASMN0RK2, and ASMW0RK3 data 
sets. 

PRNTRl is the name of a print device. 



Specify Data Sets ( Prompt/Repl v Mode) 






A sample printout showing the prompt/reply format of $L to 
invoke $S1ASM and specifying these data sets follows? 



> $L $SlASM>ASriLIB 




SOURCE (NAME, VOLUME) 


ASMSRC 


NORKl (NAME, VOLUME) 


ASMWORKl, EDX003 


W0RK2 (NAME, VOLUME) 


ASMIJORK2,EDX003 


W0RK3 (NAME, VOLUME) 


I ASMWORK3,EDX003 


OBJECT (NAME, VOLUME) 


ASMOBJ 


MACLIBl (?): 





Specify Data Sets (Single Line Mode) 



A sample printout showing the single line format of $L to 
invoke $S1ASM and specifying these data sets follows: 
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> $L $SlASri,ASMLIB ASMSRC ASMWORKl, EDX003 ASMW0RK2, EDX003 
ASMWORK3,EDX003 ASMOBJ 

MACLIBl (?): 



o 



Specify Macro Libraries 



In both of the previously shown modes* you are prompted as fol 

lOMS i 



MACLIBl (?): 



If you require macros for this assembly* you can specify one or 
two macro library volumes. A null response (ENTER) takes you to 
the next prompt (SELECT OPTIONS). If a MACLIBl is specified (as 
shown in the following example)* another prompt (MACLIB2) 
appears : 



A:., 



.y 



MACLIBl (?): MACLBl 
MACLIB2 (?): 



You can supply the name of another macro library or enter a null 
response . 

Note i If your source program contains Event Driven Language 
instructions* you must specify* as either MACLIBl or MACLIB2> 
the name of the volume(s) that contains the Event Driven Execu- 
tive Macro Library (5719--LM5) and copy code. 
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Specify Assembly Options 



After entering the macro library volume name(s) and/or a null 
response* you are prompted as follows: 



ENTER OPTIONS (?): 



Following is a list of possible replies: 

♦ Enter a null response and take the default options (LIST* 
OBJECT, MACRO) 

• Enter the options you desire (for example, LIST, NOXREF, 
NORLD). See "List of Options" on page 378. 






Enter a question mark to display a list of the available 
options. After the options are displayed, the ENTER 
OPTIONS (?): prompt is displayed. 

Enter the options of your choice, followed by the name of 
your output device. This prevents the next prompt from 
appearing. 



If you do not specify the name of the output device with your 
options, as follows: 



ENTER OPTIONS (?): L 1ST, NOXREF , NOR LD 



Chapter 5. Application Program Preparation 375 



SSIASM 



You are prompted with 






ENTER OUTPUT DEVICE NAME 



You can enter the name of the device on which your listings and 
diagnostic messages are to be written. If you do not specify an 
output device (a null response)! it defaults to $SYSPRTR. 

The next message displayed is: 



CPAOOOI ASSEMBLER STARTED 



'v.y 
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Complete Example: 

A complete example follows using: 

• ASMSRC for the source library 

ASMWORKl, ASMW0RK2, and ASMW0RK3 for work files 

• ASMOBJ for the output file 

• MACLBl for the macro library 

• PRNTRl for the output listing. 
Invoke $S1ASM and Specify Data Sets to Use 



> $L $S1ASM,ASMLIB 

SOURCE (NAME, VOLUME) 
WORKl (NAME, VOLUME) 
W0RK2 (NAME, VOLUME) 
WORKS (NAME, VOLUME) 
OBJECT (NAME, VOLUME) 

MACLIBl (?): MACLBl 

MACLIB2 (?): 

ENTER OPTIONS (?) : ? 



ASMSRC 

ASnWORKl,EDX003 

ASMWORK2,EDX003 

ASMWORK3,EDX003 

ASMOBJ 
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List of Opt i ons 



If you enter a question mark in response to the prompt ENTER 
OPTIONS* the following list of options is displayed: 



VALID OPTIONS 
LIST/NOLIST - 



ARE: 

COMPLETE ASM LISTING/ 
ERRORS ONLY 
TEXT/NOTEXT - SOURCE AND OBJECT 
ESD/NOESD - LIST EXTERNAL SYMB 
SUPPRESS THIS OPTI 
RLD/NORLD - LIST RELOCATION DI 
SUPPRESS THIS OPTI 
XREF/NOXREF/FULLXREF - LIST REFE 

NO XREF L 
LIST ALL 
OBJECT/NOOBJECT - WRITE OBJECT T 

SUPPRESS THIS 

MACRO/NOMACRO PROCESS MACROS 

DO NOT PROCESS 
SYSPARMC ' . . . ' ) — SUBSTITUTION S 

LINECOUNT(N) LINE/PAGE FOR 

DEFAULT N = 55 

SETC(N) NUMBER OF CHAR 

SETC SYMBOLS 

END TERMINATE OPTI 

CA TO CANCEL ASSE 



LISTING/ 

OL DICTIONARY/ 

ON 

CTIONARY/ 

ON 

RENCED SYMBOLS/ 

ISTING/ 

SYMBOLS 

OBJECT FILE/ 

OPTION 

IN SOURCE/ 

MACROS IN SOURCE 
TRING FOR MACRO PROCESSIN 
ASM LIST 

LINES/PAGE 
ACTERS ASSIGNED TO 

ONS PROCESSING 
MBLY 



ENTER OPTION(S) SEPARATED BY COMMAS 
DEFAULT OPTIONS ARE: "LIST , OBJECT , MACRO" 



I 
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Select processing options 



You now enter the options of your choice and are prompted as 
follows. A message is displayed indicating that the assembler 
has started . 



ENTER OPTIONS (?): LISTi NOXREF, NORLD 
ENTER OUTPUT DEVICE NAME: PRNTRl 
CPAOOOI ASSEMBLER STARTED 






Single line format 



Combining your inputs* using the single line format* the previ 
ous example looks like this: 



> $L $SlASri,ASMLIB ASMSRC 


ASnNORKl>EDX003 


ASMM0RK2j 


EDX003 


ASMWORK3,EDX003 ASMOBJ 












MACLIBl (?): MACLBl 












MACLIB2 (?): 












ENTER OPTIONS (?): LIST^NOXREFj 


>NORLD 


PRNTRl 




CPAOOOI ASSEMBLER STARTED 
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Invoking $S1ASM Using $JOBUTIL 



$S1ASM can be invoked using $JOBUTIL. The same options are 
available through the PARM facility of the job stream processor 
($JOBUTIL) as were described previously under the $L command. 
If the default options are required^ the PARM card can be blank 
but must be included in the procedure. A sample procedure that 
parallels the previous example using $L follows: 



PROGRAM 


$S1ASM,ASMLIB 






DS 


ASMSRC 






DS 


ASMWORK1,EDX003 






DS 


ASMWORK2,EDX003 






DS 


ASMWORK3,EDX003 






DS 


ASMOBJ 






PARM 


MACLBl 


PRNTRl 


LIST,NOXREF,NORLD 


EXEC 









Not e t Parameters of the PARM statement in the preceding sample 
are column dependent? 



H,,, 



MACLBl must start in column 10 

MACLB2> if coded, must start in column 20 

PRNTRl must start in column 30 

The option list must start in column 40 
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Invoking $S1ASN Using the Session Manager 



To invoke $S1ASM using the session manager, select option 2 
from the progratn preparation secondary option menu. 

The following parameter selection menu is displayed for entry 
of the required data sets and optional parameters. The example 
shows the data set ASMSRC is to be assembled with the object 
output being directed to the data set ASMOBJ . 



^r\, 



$SMM0202: SESSION MANAGER $S1ASM PARAMETER INPUT MENU — 
ENTER/SELECT PARAMETERS: DEPRESS PF3 TO RETURN 



SOURCE INPUT (NAME, VOLUME) ==> ASMSRC, EDX002 
OBJECT OUTPUT ( NAME , VOLUME ) ==> ASMOBJ, EDX002 
ENTER OPTIONAL PARAMETERS BY POSITION : 



MAC LB 1 
1 

MACLIBl 
(VOLUME) 



PRNTRl 
3 

PRINTER 
NAME 



2 3 4 

MACLIB2 
(VOLUME) 



LIST,NORLD,NOXREF 

4- 

ASSEMBLER OPTIONS 

SEPERATED BY COMMAS 
LIST/NOLIST XREF/NOXREF/ 



TEXT/NOTEXT 
ESD/NOESD 

RLD/NORLD 



FULLXREF 
MACRO/NOMACRO 
OBJECT/ 
NOOBJECT 
LINECOUNT(N) 

N=LINES/PAGE 



DEFAULT OPTIONS ARE: 
LIST 
OBJECT 
MACRO 
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HOST ASSEMBLER 



Assembly of Event Driven Executive programs on an IBM 
System/370 requires installation of the following programs on 
the System/370 . 

• FDP 5798-NNQ* System/370 Program Preparation Facilities 
for Ser i es/1 

• 57^0-LM2, Event Driven Executive Macro Library/Host* as is 
described in the System 6u i de . 



Invoking the Host Assembler 



It is assumed in the following discussion that the procedure 
EDXPREP (described in the System Guide ) is installed as a cata- 
loged procedure. If the procedure is not cataloged* it can be 
used inline. This procedure makes use of the host assembler 
program of 5798--NNQ and the macro library and listing program 
EDXLIST provided by 57<^0~LM2. The function and operation of 
EDXLIST is described under "EDXLIST - Host Listing Formatter" 
on page 383. 

Program assembly is accomplished by modifying the source and 
object program names specified in the SySIN and SYSOUT DD 
statements of EDXPREP to reflect your program names* followed 
by execution of the procedure. 

Source programs can contain both Event Driven Language 
instructions and Series/1 assembler language instructions. 
Refer to the USER instruction in the Lang uage Reference for 
information concerning inclusion of Series/1 assembler 
i nst r uct i ons , 

The object module produced by the assembly process can be 
either a main program or a subprogram* as described in the 
MAIN= operand of the PROGRAM instruction in the Language 
Reference . 



^ 
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Transferring the Object Module to Series/1 



There are various methods which can be used to transfer object 
modules created on the System/370 to the Series/1. 

If lUP 5796-PGH» Event Driven Executive Host Communication 
Facility* is installed on the System/ 370 then utility programs 
$HCFUT1 or $UPDATEH can be used. If the object module is a main 
program and is not to be linked together with any other object 
modules* $UPDATEH can be used to read the object module from 
the System/ 370» convert it to an executable program, and store 
it in a Series/1 disk or diskette. If the object module is to be 
link edited with other object modules, it can be transferred to 
the Series/1 by using the READOBJ command of utility program 
$HCFUT1. 






If lUP 5796-PGH is not installed on the Sy5tBm/370, but a bina- 
ry synchronous communication link exists between the 
System/370 and the Series/1, then the utility program $RJE2780 
or $RJE3780 can be used to transfer object modules from 
System/370 to the Series/1 if suitable 2780 or 3780 support is 
installed on the System/ 370. Modules transferred in this man- 
ner must then be processed by $LINK and/or $UPDATE to convert 
them into executable programs. $RJE2780 or $RJE3780 can also 
be used to submit the source program for assembly on the Sys- 
tem/370. 



If the object module is a subprogram, it must be transmitted to 
the Series/1 for link editing with a main program before it can 
be converted into executable format by $UPDATE. 

A complete main program object module only requires processing 
by $UPDATE on the Series/1 to convert it to executable form. 
Refer to "$UPDATE - Object Program Converter" on page ^08. 

Program preparation of Event Driven Language programs on a Sys- 
tem/370 does not use the Series/1 Native Application Load 
Faci li ty, 5798-NNR. 



EDXLIST - Host Listing Formatter 



The purpose of the EDXLIST program is to reduce the size of, and 
improve the readability of, the program listing. When the 
PRINT GEN option is used for an assembly containing macros, the 
macro generated code appears on the assembler produced listing 
following each source statement. Event Driven Language 
instructions are implemented as macros, each macro generating 
an average of six bytes of object code. The object code is gen- 
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erated using the assembler DC statement. 

Example:: The following example shows the format of the assem- 
bler listing for a small section of a program: 



LOC 


OBJECT CODE 


STMT 


SOURCE 


STATEMENT 






1 


MOVE 


A,B 


0000 


005C 


2 + 


DC 


A($M0V2) 


0002 


OOOC 


3 + 


DC 


A(A) 


0004 


OOOE 


A + 


DC 


A(B) 






5 


ADD 


B,C 


0006 


0033 


6 + 


DC 


A($AD222) 


0008 


OOOE 


7 + 


DC 


A(B) 


OOOA 


0010 


8 + 


DC 


A(C) 






9 A 


DATA 


F'O' 


OOOC 


0000 


10 + A 


DC 


F'O' 






11 B 


DATA 


F»o» 


OOOE 


0000 


12 + B 


DC 


F»0' 






13 C 


DATA 


F'O' 


0010 


0000 


1«^ + C 


DC 


F»0' 



'■4- Ji^ 



This listing is difficult to read because of the mixture of 
source statements and macro generated object code. The purpose 
of the list post processing program* EDXLIST, is to condense as 
much of the listing as possible and to print only essential 
information in a more readable format. 

EDXLIST takes each source statement and prints on the same line 
with it the object code generated by the macro expansion. Each 
line has room for 10 bytes of data so that nearly all 
instructions can be printed on one line. This gives the assem- 
bly the appearance of being an actual assembler type language. 
The results of processing the above example with EDXLIST is 
shown below: 



o 
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LOC 


OBJECT CODE 


STMT 


SOURCE 


STATEMENT 


0000 


005C OOOC OOOE 


1 


MOVE 


A,B 


0006 


0033 OOOE 0010 


6 


ADD 


B,C 


OOOC 


0000 


9 


DATA 


F'O' 


OOOE 


0000 


11 


DATA 


F'O' 


0010 


0000 


13 


DATA 


F'O' 



Program Options 



A number of options are provided to further condense or elimi- 
nate cross reference and relocation dictionary^ as well as your 
own and macro generated comments. 






To use EDXLIST» the assembly output must be directed to a data 
set rather than the customary SYSOUT class. For example: 



//SYSPRINT DD 
// SPACE=. 



DSN=$$PRINT,DISP=(,PASS) , 
. ,UNIT=. . . ,DCB=(BLKSIZE=. 



This data set then becomes input to the EDXLIST program 
pie job control statements are shown belowJ 



Exam- 



//LIST 



EXEC PGM = EDXLIST,PARM=MSA(16)/. . . FARMS' 



//STEPLIB 

//SYSPRINT 

//WORK 

//IN 

//LIST 



DD DSN=... 

DD SYSOUT=A 

DD DSN=$$W0RK,UNIT=SYSDA,SPACE=(TRK,5) 

DD DSN=$$PRINT,DISP=(OLD,PASS) 

DD SYSOUT=A 



The IN DD card refers to the data set containing original 
assembler listing and the LIST DD card refers to the new list- 
ing produced by EDXLIST. 
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If in addition to the above* the original assembler listing is 
also required* the host utility program lEBPTPCH can be used in 
the following manner to produce it: 



//BIGLIST 


EXEC 


//SYSPRINT 


DD 


//SYSUTl 


DD 


//SYSUT2 


DD 


//SYSIN 


DD 



PGM =IEBPTPCH 

SYSOUT=A 

DSN=$$PRINT,DISP=(OLD,PASS) 

SYS0UT=A,DCB=BLKSIZE=133 



PRINT PREFORM=A 



EXEC Statement Parameters 



A number of parameters for the EDXLIST program can be specified 
on the EXEC statement. A list of the options follows. Default 
values can be found under "Defaults" on page 388. 



PRINTER 

TERMINAL 

TERMINALE 

SEQ 

STMT 

CONTROL = )<><M 



COMMENTS=NONE 
COMMENTS=ALL 



Output is listed on a printer. 

Output is listed on a terminal. 

Same as TERMINAL* except only error messages 
and associated source statements are 
pr i nted . 

Source code sequence numbers are printed. 

Assembler statement numbers are printed. 

Defines a special control card that is recog- 
nized as an execution time control statement. 
Any two characters can be specified for the 
second and third characters; the first* how- 
ever* must be an '^'. See control options 
below. 

Print no comments. 

Print all comments. 



J 



COMMENTS=PROGRAM Print only comments not generated by macros. 
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COMMENTS=CONTROL Print comments only if columns 1, 2, and 3 

match the value specified in the CONTROL= 
parameter . 



EQUATES = )« 



Print only macro generated equates of the 
form +LABEL EQU ^. 



EQUATES=PROGRAM Print only equates not generated by macros. 
LABELS=PROGRAM Print labels not generated by macros. 



LABELS=PEND 

START=PROGRAM 

START=START 

XREF=NONE 
XREF=$ 

XREF=ALL 
XREF=:AREF 

XREF=$REF 

RLD=YES 

RLD=NO 

N o t e s t 



Same as PROGRAM except all labels after the 
ENDPROG statement are printed. 

All listings before the PROGRAM statement are 
not pr i nted . 

Printing is to begin at first line of list- 
ing. 

Cross-reference listing is not printed. 

Print abbreviated cross-reference listing 
with the exception of labels beginning with 
the character §. 

Same as $> except $ labels are included. 

Same as ALL* except statement references are 
i nc luded . 

Same as AREF» except $ LABELS are included. 

Print condensed relocation dictionary. 

Do not print relocation dictionary. 



1. If both STMT and SEQ are specified, then statement 
numbers appear to the left of the source code and sequence 
numbers in the right margin. If only one is specified* the 
numbers appear to the left of the source code. 

2. XREF = ALL or XREF = $ print ofily the label name and its 
address and these are placed in seven columns across the 
page . 

3. XREF = AREF or $REF prints one label per line and all 
statement numbers referencing the label are printed. If 
this option is selected* it is assumed STMT was also speci- 
fied. 
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If START=PROGRAM is specified and there is no PROGRAM 
statement* then the listing is printed as if START=START 
was coded . 

Whenever one of the following control statements appears 
in the assembler listing* then the special listing func- 
tions occur. 



Control Options 



^XXEJECT 
HXXSPACE 1 
xXXSPACE 2 
^XXTITLE X 



^XXLIST ON 
^XXLIST OFF 



Skip to a new page 
Skip one line 
Sk i p two 1 i nes 

maximum 50 characters X 

Will print this character string at the 

top of each successive page. 

List input exactly as it appears on 

original listing 

Resume listing compression. 



~^.._.,>' 



N ote : "^XX* represents the three characters 
CONTROL= parameter discussed previously. 



coded in the 



These control statements are treated as comments by the assem- 
bler. The macros EJECT, SPACE, and TITLE distributed in the 
library SI . EDX . LISTMAC , ASM will create control statements with 
the characters ^^^ in columns 1, 2, and 3. Thus, when the cor- 
responding assembler listing control statements appear in the 
source program, the appropriate control statements are created 
for EDXLIST. They require CONTROL=k^x in the PARM field. 



Defaults 




\J 



388 SC34-0313 



o 



Host Assembler 



PRINTER 


TERMINAL 


STMT,SEQ 


STMT 


COMMENTS=PROGRAM 


COMMENTS=NONE 


EQUATES=^ 


EQUATES=^ 


LABELS=PEND 


LABELS=PEND 


START=PROGRAM 


START=PROGRAM 


XREF=$ 


XREF=:NONE 


RLD =YES 


RLD=NO 
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SLINK - LINKAGE EDITOR 



The $LINK program provides a linkage editor capability to aid 
in preparing programs to execute in an Event Driven Executive 
system. With $LINK, you can: 

• Combine two or more separately compiled or assembled 
object modules into a composite module 

• Combine modules with multiple control sections* for exam=^ 
ple» COBOL, FORTRAN, and PL/I programs, into a composite 
module 

• Format the output of $S1ASM for input to $UPDATE 

• Eliminate duplicate control sections from the input mod- 
ules 

• Automatically include standard routines referenced by the 
program (AUTOCALL) 

• Provide a storage map of the combined, edited modules 

• Build an EDX supervisor nucleus 

Each of tfiese is explained in this section. 

The object modules that are input to $LINK can be created by any 
of the following program preparation facilities: 

$EDXASM 

$S1ASM 

FORTRAN 

COBOL 

PL/I 

Host Assembler (FDP 5798-NNQ) 

$LINK accepts object modules that are in the compressed record 
format created by the Realtime Programming System assembler. 

A $LINK output module must be formatted by the utility program 
$UPDATE to convert it to executable (loadable) form. Figure 23 
on page 391 illustrates the steps necessary to prepare a pro- 
gram for execution. 






^'iu^-i''^ 
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Source 
module 




Input object 
module 



L 



Output object 
module 



L 



Executable (relocatable) 
load module 



Com[)utor 



Ltinciuago 
translator 




SLINK 




SUPDATE or 
SUPDATEH 



Program 
L'xiicution 



I Figure 23. Programming with a linkage editor 
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Every program is designed to fulfill a particular purpose. To 
achieve that purpose, tlie program can often be divided into 
logical units that perform specific functions. A logical unit 
of code that performs a function, or several related functions, 
is called a source module. 

Each source module can be program nied as a separate entity using 
an appropriate programming language (for example. Event Driven 
Language, 5eries/l Assembler Language, COBOL, FORTRAN, PL/I, 
or the host assembler) arid assembled or compiled. The resulting 
object module can then be processed by $LINK, along Nith the 
other object modules that are necessary to make up the entire 
program. 

Preparing source modules as separate logical units allows you 
the ability to modify one part of a program and requires the 
reassembly or recomp i la t i on of only the modified unit (fol- 
lowed by another execution of $LIMK), as opposed to requiring 
tlie reassembly or recompilation of the entire program. It also 
allows a function that is common to several programs to be 
coded and assembled or compiled once and then included wherever 
needed, saving effort and ensuring consistency. Linkage edit- 
ing, if needed, follows the source program assembly or compila- 
tion of a program . 



\....^ 



Multiple Control Sections 



A control section (CSECT) is a unit of code (irist ructions and 
data) that is, in itself, an entity. All elements of a control 
section have a constant relationship to each other and, there- 
fore, it is the smallest separately relocatable unit or a pro- 
gram. Separate compilations always produce individual control 
sections, but multiple control sections can be produced from a 
single compilation as well. The COBOL, PL /I, and FORTRAN com- 
pilers always produce multiple CSECTs and, therefore, their 
output must always be processed by $LINK. $S1ASM and the host 
assembler will also produce multiple control sections if the 
CSECT instruction is used. 



Formatting Modules for $UPDATE 



The output object modules of $S1ASM and the Realtime Program- 
ming System Program Preparation Subsystem assembler must be 



o 
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reformatted by $LINK prior to $UPDATE processing. The standard 
link edit process does the reformatting and no special parame- 
ters are requ i red . 



I Notes : 



2. 



$UPDATEH can handle host assembler modules without link- 
editing. 

The output of the Realtime Programming System language 
processors must be link-edited before processing by $UP- 
DATE. 



Elimination of Duplicate Control Sections 



If the input to $LINK contains more than one control section 
(CSECT) with the same namei the first section is kept» all 
subsequent sections with the same name are deleted and all 
references are adjusted to point to the first CSECT. This makes 
the resulting program smaller and assures that there is only 
one copy of any shared data areas. 



I Automatic Inclusion (Autocall) 



Frequently used routines can be assembled or compiled as sepa- 
rate modules and automatically included in any program that 
references them by using the AUTOCALL facility of $LINK. This 
technique makes it convenient to define and use standard rou- 
tines almost as if they were instructions. The Event Driven 
Language FORMAT, GETEDIT, and PUTEDIT instructions use this 
technique. See "Autocall Option" on page <^01 for detailed 
information on using the autocall option. 



Storage Map 



$LINK produces a table showing the name, location! and length 
of all control sections in the program plus the location of 
symbols (entries) defined as referenceable by the entire pro- 
gram. This is useful in debugging and in determining the total 
size of the program. 
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Building an Event Driven Executive Supervisor 



$LINK and the link edit process are used to generate a custom- 
ized supervisor by selectively including the modules needed 
for the desired functions. See the System Guide for further 
information. 



The Link Edit Process 



The logical structure of an object module consists 
entities: 



of three 



ESD An external symbol dictionary that includes the name of 
each external symbol* the type of reference it is» and 
its location in the program. ESD entries represent sym- 
bols such as the label on a PROGRAM, CSECT, or ENTRY 
statement, or the label of a DATA or DC statement that 
defines an A-type constant. 

RLD A relocation dictionary that contains an entry for each 
address that must be relocated (adjusted) before the 
module is executed. Each entry specifies an address con- 
stant by indicating its location in the program. 






TEXT An area that contains the instructions and data of the 
program in the binary codes used by the Event Driven 
Executive and/or the Series/1 processor. 




Each object module is assigned a program origin (usually zero) 
during assembly or compilation. When these object modules are 
link-edited, $LINK assigns an origin (load point) to the text 
for the primary program and adjusts the RLDs describing address 
constants accordingly. The text for the other object modules, 
as well as the address constants, are assigned addresses rela- 
tive to the origin (load point) assigned to the primary pro- 
gram. This causes the link-edited (combined) text for all 
object modules to occupy consecutive addresses in the output 
object module produced by $LINK. See Figure Z^ on page 395. 



o 
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Any object module that refers to an external symbol defined in 
another object module must identify it as an externally defined 
symbol. External symbols (EXTRNS or WXTRNS) between these mod- 
ules are resolved by matching the referenced symbols to defined 
symbo Is . 



The ESDs and RLDs of the object modules are combined to form 
composite ESDs and RLDs for the complete program. The output 
RLDs include relocatable information for the complete text of 
the output object module of $LINK. 

I An output object module produced by $LINK looks as follows. 

I 



^^" ), 

















Output 

object 

modules 


Input object , 
modules 


/ 


ESD 




TEXT 


^ 




RLD 


^s. 






CESD 






^ 


$LINK 




TEXT 




k 


ESD 


y^ 






RLD 


^^ 




TEXT 




RLD 

















Chapter 5. Application Program Preparation 



395 



$LXNK 



Input to SLINK 



Input to $LINK consists of LINKCNTL* the data set containing 
control records* the various data sets containing the object 
modules to be linked together* and the optional autocall data 
set . 

You must provide the names of the input and output object mod- 
ules to $LINK with a set of control records stored in a disk or 
diskette data set called LINKCNTL. How to format and create 
these control records is described under "Control Records." 

In addition to the data set containing the control records* You 
must also allocate two work data sets on disk or diskette. The 
message data set $LEMSG is supplied with your installation 
package and is required by $LINK. A description of all of the 
data sets is contained under "Data Sets Used by $LINK" on page 
400» along with suggestions for selecting the sizes of the data 
sets . 

I A sample of input to $LINK follows: 
I 



OUTPUT 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

END 



LEOUT,DAN01 AUTO= LEAUTO, DANO 1 

LETEST,DAN01 

LETEST1,DAN01 

LETEST2 

LETEST3,DAN01 



\,J^ 



Control Records 



You must allocate the control record data set (LINKCNTL) using 
$DISKUT1. Then enter the control records with $EDIT1N or 
$FSEDIT and store the records with either SAVE or WRITE. 

LINKCNTL should contain the names of the input object modules, 
the names of the output object modules* and other control 
information. Both data set name and volume name are required on 
all OUTPUT and INCLUDE records, unless the data set resides on 
the IPL volume. In the latter case, only the data set name is 
requ i red . 
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Any number of leading blanks are permitted in control records* 
but the record must not be longer than 71 characters. Any 
record with an '^' in position 1 is treated as a comment and 
will list out on the printed output. 



All the parameters used must be coded in the order shown, 
parameters must be separated by one or more spaces. 



The 



END Record 



The END record terminates the control record string 
format is: 

Syntax 



The 



END 

Requ i r ed : None 
Default: None 



No operands are required. 
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The INCLUDE records specifies the input object module to be 
link-edited. You can include several input object modules but 
you must have an INCLUDE record for each input object module. 
The format i s : 

Syntax 



INCLUDE name>volume 

Required: name 

Default: Volume defaults to IPL volume. 



Operands 
name 

volume 



Descr i pt i on 

The name of the input object 
link-edited. There must be one 
betueen 'INCLUDE* and 'name'. 



module 
or more 



to be 
spaces 



The disk or diskette volume that contains 'name*. 
Not required if 'name' resides on the IPL volume. 
The first INCLUDE record cannot specify the name of 
a subprogram (i.e.» one with MAIN=NO in the PROGRAM 
statement or one that does not contain a PROGRAM 
statement). All other INCLUDE records should spec- 
ify the names of subprograms. 



V„r:V 



All of the ' name » volume ' specifications on INCLUDE records 
must be unique in the input to $LINK. In a like manner^ all 
ENTRY labels and program section (CSECT) definitions must be 
unique (i.e.* the same name cannot be used for both a CSECT and 
an entry* or for two ENTRYs* etc.). Duplicate symbol type 
errors will result if these rules are not observed. If $LINK 
encounters two or more CSECTs with the same name» the first one 
will be accepted and all others ignored. 

CSECTs input to $LINK must not have a length of zero. 
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OUTPUT Record 



There can only be one OUTPUT record in LINKCNTL and it must be 
the first record (excluding comment records) in the data set. 
The format i s : 

Syntax 



OUTPUT name, volume NOMAP AUT0=name2 , vo lume ENTRY=label 



Requ i red '» 
Default : 



name 
Volume 



defaults to IPL volume. 



Operands 



Descr i pt i on 



name 



The name of the data set (previously allocated on 
disk or diskette) to contain the output object 
module from $LINK. There must be one or more spaces 
between 'OUTPUT' and 'name*. 



volume The name of the disk or diskette volume containing 
the output data set. 



NOMAP 



This parameter suppresses printing of the storage 
map portion of $LINK output starting with the line 
which begins 'OUTPUT NAME=' and continuing through 
the final C5ECT or ENTRY listing line. See the sam- 
ple printout for details. 



AUT0=name2,volume 



This parameter specifies the name (and volume if 
the data set is not on the IPL volume) of the data 
set containing the list of names of object modules 
which may be included via the autocall facility. A 
further discussion of the autocall option is pro- 
vided under "Data Sets Used by $LINK" on page 400 
and "Autocall Option" on page <^01. 



ENTRY=label 



This parameter is used only if the output of $LINK 
is to be an Event Driven Executive supervisor 
program ($EDXNUC). .When generating a supervisor, 
'ENTRY=$START' must be coded. 
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Data Sets Used by $LINK 



$LINK requires you to specify three data set names at the start 
of program execution (one if invoked by the Session Manager). 



LINKCNTL (DSD 



LEWORKl (DS2) 



LEW0RK2 (DS3) 



The data set 
records . 



that will contain the control 



A work data set that will contain various 
intermediate work areas for $LINK. This data 
set must be at least 265 records and will 
require approximately 1 additional record for 
each 60 RLD items or for each ^2 program section 
definition (CSECT) or ENTRY specifications. 
400 records should be sufficient for almost any 
program . 

$LINK dynamically divides DS2 into three 
sections and refers to them as DS2» DS7» and 
DS8. Therefore* error messages which reference 
DS7 or D58 actually refer to portions of DS2. 

The session manager automatically allocates 
400 records to DS2. Its name is $SMluser (where 
user is the sign on ID used), the sign on ID 
used ) . 

A second work data set. This data set contains 
a work area for $LINK» plus the storage area 
where all $LINK printed output is stored until 
it is printed at the end of $LINK execution. A 
size of 20 records plus 1 record for each 3 
lines of printed output expected should be 
sufficient. The amount of printed output 
varies with the number of INCLUDE records* the 
number of unresolved EXTRNs and WXTRNs* etc. A 
data set size of 150 records should be suffi- 
cient for most programs. 

If the space available for messages in DS3 
becomes filled* then the message file will be 
printed before the end of $LINK execution, 
$LINK then refills the message file as needed. 
This condition can result in the printed If you 
are executing other programs from the same 
terminal doing $LINK* the printed output will 
be interspersed with the output from the other 
programs . 






v.y' 
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The session manager automatically allocated 
''+00 records to DS2 . Its name is $SM2user (where 
user is the sign on ID used). 

The optional data set specified by the AUTO= parameter of the 
OUTPUT record is dynamically opened as DS9 by $LINK. At least 
one record in DS9 is required for every object module named in 
the autocall list. 

In addition* the data set $LEMSG must be installed on volume 
ASMLIB. $LEMSG is supplied as part of the distributed system 
and contains messages used by $LINK and is referenced as 'DS<^* 
by $LINK. $LINK dynamically opens the data sets specified by 
the OUTPUT and INCLUDE records as 'DSS' and 'DS6', respective- 
ly. 

The data set specified by the OUTPUT control record may need to 
be as large as 350-^50 records when link editing $EDXNUC. 



Autocall Option 



$LINK provides a limited autocall option whereby modules that 
are not explicitly included (via the INCLUDE control record) in 
the output object module can be automatically incorporated. 
When you code the AUTO= parameter of the OUTPUT record* specify 
the name (and volume unless the data set is on the IPL volume) 
of the data set that contains the list of object module 
names/volumes* along with their entry point names* which are 
available for automatic inclusion in the output object module. 



Standard Autocall List 

As part of the distribution of the Event Driven Executive sys- 
tem* a standard autocall list is included in the data set $AUTO 
in volume ASMLIB. This standard list contains the names of the 
modules and entry points that can be autocalled as a result of 
including the following functions in your program: 

♦ graphics formatting instructions 

♦ data formatting instructions 

• screen formatting subroutines 

• square root function. 
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These functions generate EXTRN statements that are resolved by 
specifying AUTO=$AUTO, ASMLIB . 



\ 



Using a Special Autocall List 

To add your own autocall list names to those provided in $AUTO» 
use $EDIT1N or $FSEDIT to make the additions and then save the 
resulting modified list as a saved data set with a name of your 
choice. This data set name (and volume) are specified in the 
AUTO= parameter of the OUTPUT record. 'If you use the functions 
listed previously in your programi you will need to merge the 
contents of $AUTO into your autocall list. 



Using the Autocall Feature 



Perhaps the most common use of the autocall feature occurs when 
you have assembled some number of commonly used subroutines 
that may or may not be needed by a given primary program. When 
you assemble a primary program* you can link edit it with the 
required subroutines by providing an INCLUDE record for the 
primary program and for each required subroutine. An alternate 
method is to put the names of all potentially needed subrou- 
tines and their entry point names into the autocall list* then 
provide only an INCLUDE record for the primary program and add 
the AUTO= parameter to the OUTPUT record. The method that is 
most efficient depends upon how your programs are organized and 
the frequency with which common subroutines are used. 

You must provide EXTRN statements in the primary program for 
the entry point names in the modules to be autocalled as well as 
linkage (branches) to the desired entry points in the 
autocalled modules. Modules that have been included with the 
autocall can contain EXTRNs that are to be resolved by further 
autocall processing. $LINK searches the autocall list repeat- 
edly until either all EXTRNs have been resolved or until no 
ENTRY in the autocall list matches an unresolved EXTRN. 



W,.y 



M XTRN Processing 



The autocall list is not searched for ENTRY points to match 
unresolved WXTRNs. They are resolved only from the ENTRY defi- 
nitions contained in the modules included (via the INCLUDE con- 
trol record) or autocalled. An unresolved WXTRN has no affect 
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upon $LINK completion codes and the storage location contain- 
ing the WXTRN is set to relocatable zero. Therefore* at program 
execution time* the addresses of unresolved WXTRN's are the 
program load point. 



A utocall List Record Format 

The format of the autocall list records is shown below. They 
can most conveniently be created as the saved output of a 
$EDIT1N or $FSEDIT editing session using tab settings of 20, 
30, ^0, 50 and 60. Each input line must contain the 
"name, volume* entry of the object module to be autocalled, 
starting in postion 1. Up to 5 entry point names can be speci- 
fied per line, starting in positions 20, 30, 40, 50, and 60. If 
a data set has more than five entry points, multiple lines are 






name field. 'Volume* is required for each *name 
the IPL volume. For example: 



1 i ne pos i t i on : 
1 20 



NAME1,V0L1 
NAME2,V0L1 



30 



'^O 



50 



60 



ENTRYl 
ENTRYA 



ENTRY2 
ENTRYB 



ENTRY3 
ENTRYC 



^^END 



Output from SLINK 

The result of executing $LINK consists of a printed listing and 
an output object module, A sample of the printed listing fol- 
lows. It consists of a start message, a list of the input con- 
trol records, a list of any unresolved EXTRN or WXTRN labels 
(none in example), an optional map of program section (CSECT) 
and ENTRY point locations in the output module, a length mes- 
sage, and an ending message. All numeric values are given in 
hexadecimal, except the RLD COUNT field. 
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$LZNK 



$L.INK 
$LINK 



EXECUTION 
EXECUTION 



STARTED 
CONTROL 



RECORDS 



LINKCNTL,EDX002 

LEOUT,DAN01 AUTO=LEAUTO , DANO 1 

LETEST,DAN01 

LETEST1,DAN01 

LETEST2 

LETEST3,DAN01 

SUB^,DAN01 VIA 

SUB5,DAN01 VIA 



LEOUT 
LABEL 



ADDR 



$PROGRAM 0000 



FROM 
OUTPUT 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
END 
OUTPUT NAME= 

ESD TYPE 

CSECT 
CSECT 

ENTRY 

ENTRY 
CSECT 

ENTRY 

ENTRY 

ENTRY 
CSECT 

ENTRY 

ENTRY 

ENTRY 
CSECT 

ENTRY 
CSECT 

ENTRY SUBS 
MODULE TEXT LENGTH= 
LEOUT ADDED TO 
$LINK COMPLETION CODE= -1 



AUTOCALL 
AUTOCALL 



SUBl 
DEF 

I 

MSG 

SUB2 

X 

SUB3 
ABC 

SUBA 



OOFO 
00F2 
OlOF 
0116 
0116 
OllA 
013E 
015A 
015A 
0160 
0180 
018E 
0190 
OIBO 
01B2 

OICE, RLD 

DANOl 



LENGTH 



OOFO 
0026 



0044 



0034 



0022 



OOIE 



COUNT= 



40 



'^.V 



The printed output can be directed to any terminal on the 
system by passing the terminal name as a parameter ($PARM1) to 
$LINK, If the parameter is not passed to $LINK at program load 
time, you will be prompted to enter the desired name from the 
invoking terminal. A null response to the prompt for the termi- 
nal name routes the output to the system printer* $SYSPRTR. 

The output object module is stored in the disk or diskette data 
set specified by the OUTPUT control record if no errors occur 
that are severe enough to cause $LINK to terminate (e.g., disk 
hardware errors). However, the output module is probably not 
usable if any errors occurred during $LINK execution. Refer to 



o 
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"$LINK Completion Codes" on page ^^0 for more information. 






Invoking $LINK 



Invoking $LINK using $L and $JOBUTIL 

If you invoke §LINK with the $L from a terminal* you are 
prompted for the names (and volumes) of data sets LINKCNTL» 
LEWORKl* and LEW0RK2. You are also prompted to enter the name 
of the terminal to which the printed output is to be directed. 
An invalid name reply to the device name prompt causes the out- 
put to be directed to the terminal you are currently assigned 
to. A null reply (pressing the ENTER key or carriage return) 
causes the output to be directed to $SYSPRTR. 

$LINK can also be invoked as part of a batch procedure under the 
control of the job stream processor utility* $JOBUTIL. In this 
instance* you must supply the same information as above, with 
the D5 and FARM commands of $JOBUTIL. 

An example of invoking $LINK via $JOBUTIL commands follows: 



LOG 


$SYSPRTR 


PROGRAM 


$LINK 


DS 


LNKCONTR,MYLIB 


DS 


LNKWORK1,EDX003 


DS 


LNKWORK2,EDX003 


FARM 


$SYSPRTR 


NOMSG 




EXEC 





$LINK sets a completion code that can be tested by means of the 
JUMP command of $JOBUTIL. Successful completion results in a 
code of -1. Errors encountered during $LINK execution cause 
completion codes as shown in "$HNK Completion Codes" on page 
4A0. Any disk I/O error which causes abnormal termination of 
$LINK results in a completion code of 12. The most severe 
(numerically greatest) completion code encountered is the one 
posted when $LINK terminates execution. 
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I nvoking $LINK Using the Session Manager 



o 



To invoke $LINK using the session manager* select option 5 from 
the program preparation secondary option menu. 

The following parameter selection menu is displayed for entry 
of the control data set and volume* and the output device. The 
example shows the control data set as being LINKCNTL on volume 
EDX002. The required linkage editor work data sets were allo- 
cated at session manager log on time. 



$SMM0205: SESSION MANAGER $LINK PARAMETER INPUT MENU 

ENTER/SELECT PARAMETERS: DEPRESS PF3 TO RETURN 



LINK CONTROL (NAME , VOLUME ) ==> LINKCNTL, EDX002 
OUTPUT DEVICE (DEFAULTS TO TERMINAL) ==> $SYSPRTR 
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Object Module Record Format 



Records in object modules are 80 bytes in length* packed 3 per 
disk or diskette record or variable-length records blocked 
256. The following general description of their format is given 
as an aid in diagnosing error printouts. If error message 13 is 
received while link editing, error records will be printed. 
Object module records containing errors are printed in 
hexadecimal form if byte one equals '02'; otherwise they are 
printed in character string form. 



Byte 



Contents 



1 
2-<* 



5-6 
7-8 

9-10 
11-12 

13-lA 
15-16 



17-72 
73-80 



Hexadec i mal ' 02 ' 

One of the following EBCDIC strings: 

ESD = External Symbol dictionary record 
TXT = Text data record 
RLD = Relocation dictionary record 
END = End of object module 

Unused 

Blank for ESD, RLD, END 

Address of 1st data word for TXT 

Blanks 

Number of bytes of ESD, RLD, or TXT data 
in record 

Blanks 

ESD= External Symbol Dictionary 

Identification 

(ESDID) of first ESD item in record; 

blank if all ESD items in record are 

label definitions (LDs) 
TXT= ESD ID of control section containing 

the text , 
RLD,END= blanks 

Data items for this record 

Unused by $LINK 
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$UPDATE - OBJECT PROGRAM CONVERTER 



\ / 



^UPDATE converts an object module on a specified volume into an 
executable relocatable load module and stores it into a speci- 
f i ed volume . 

The object module used as input to $UPDATE may have been com- 
piled by $EDXASM or the host assembler provided by FDR 
5798-NNQ. An object module that is the output of the linkage 
editor, $LINKr can be the input to $UPDATE. Object modules 
created by the host assembler must be transmitted to a Series/1 
disk or diskette volume by a facility such as the IBM 2780/3780 
RJE emulation program $RJE2780/$RJE3780, or by utility program 
$HCFUT1, before they can be used as the input to $UPDATE. The 
object output of language translators other than $EDXASM or the 
host assembler must be processed by the linkage editor, $LINK, 
before it can be used as input to $UPDATE. 

$UPDATE can be invoked either by the $L command, by the batch 
job stream processor ($JOBUTIL)» or by the session manager. 
Nhen invoked, $UPDATE prompts you for the information it 
requires. Examples of this interactive usage follow. An exam- 
ple of batch job stream invocation is given at the end of this 
sect i on . 



$UPDATE Commands 



^■'C.,. 



$UPDATE commands are 



COMMAND (?): ? 

CV - CHANGE VOLUME 
RP - READ PROGRAM 
EN - END 
COMMAND (?): 



./ 



408 SC34-0313 






Examples 

Load ^UPDATE 



$UPDATE 



> $L $UPDATE 

$UPDATE 22P, , LP= <^800 

THE DEFINED INPUT VOLUME IS EDX002, OK? N 

ENTER NEW INPUT VOLUME LABEL: EDX003 

THE DEFINED OUTPUT VOLUME IS EDX003, OK? Y 



Change Vo 1 ume 



COMMAND (?): CV 

THE DEFINED INPUT VOLUME IS EDX002, OK? N 

ENTER NEW INPUT VOLUME LABEL: EDX003 

THE DEFINED OUTPUT VOLUME IS EDX003, OK? Y 

COMMAND (?): 



If volume not mounted: 

COMMAND (?): CV 

ENTER NEW OUTPUT VOLUME LABEL: 

VOLUME NOT MOUNTED 

COMMAND (?): 



EDXDFG 
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Convert and S tore a New Prog ram: This example allocates a new 
data set TESTPROG (type PGM) of the required size if a data set 
with that name has not already been allocated. 






COMMAND (?): RP 

OBJECT MODULE NAME: OBJSET 

OUTPUT PGM NAME: TESTPROG 
TESTPROG STORED 

COMMAND (?): 



Convert and Store a Nonexistent Program 



COMMAND (?): RP 

OBJECT MODULE NAME: DUMMY 

OUTPUT PGM name: PROGRAM 

INPUT DATA SET 'DUMMY' NOT FOUND 
COMMAND (?): 

Note : No action is taken when error occurs 



v^^ _^ 
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Convert Existing ^Program* That is Not a Program Type Member 



COMMAND (?): RP 

OBJECT MODULE NAME: PROGl 

OUTPUT PGM name: PR0G2 
ILLEGAL HEADER FORMAT 

COMMAND (?): 

Note : No action is taken when error occurs 



Convert Program Where Existing Output Data Set is Not Program 
Type 



COMMAND (?): RP 

OBJECT MODULE NAME: OBJSET 

OUTPUT PGM NAME: TSTPROG 
TSTPROG IS NOT A PROGRAM 
COMMAND (?): 

Note. No action is taken when error occurs. 
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Convert and Repl ace Existing Output Program with Same Output 
Name: In this example, if the existing output program is to be 
replaced with the new output program and the new and old sizes 
are the same, then the new program data replaces the old with no 
other changes. If the new space required is different from the 
existing space, the existing data set is deleted and a new one 
of the proper size is allocated wherever enough frBe space is 
a va i lab le . 



o 



COMMAND (?): RP 

OBJECT MODULE NAME: OBJSET 

OUTPUT PGM NAME: TSTPRGl 

OUTPUT PGM name: TSTPRGl 
TSTPRGl REPLACE? Y 
TSTPRGl STORED 

COMMAND (?): 



A,-,_-V 
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Convert and Rename New Output Program if an Output Program 
Already ex i sts : The existing output data set is undisturbed and 
a new data set (type PGM) of the proper size and with the new 
name is allocated. 



o 



COMMAND 


(?) : 


RP 




OBJECT 


MODULE 


NAME 


: OBJSET 


OUTPUT 


PGM NAME: 


TESTPROG 


TESTPROG REPLACE? 


N 


RENAME? 


Y 






NEW PGM 


NAME: 


TSTPRG 


TSTPRG 


STORED 






COMMAND 


(?) : 










End $UPDATE 



COMMAND (?): EN 

$UPDATE ENDED AT 11:39:3^ 
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Invoking SUPDATE 



Invoking $UPPATE Using $JOBUTIL 



When $UPDATE is invoked as part of a batch job under the control 
of $JOBUTIL» certain restrictions apply to its operation. In 
this mode» the command is assumed to be RP. The Rename function 
is not supported; however, the Replace function is. Refer to 
the preceding examples for a description of Rename and Replace. 

In batch mode, $UPDATE terminates its execution after perform- 
ing one RP command. A completion code is set by ^UPDATE depend- 
ing upon the success or failure of the requested operation. 
This code can be tested by the JUMP command of $JOBUTIL. The 
$UPDATE completion codes are described in ^^^Figure reference 
"ccupd' unresol ved^^ . 

When $JOBUTIL is used to invoke $UPDATE, the information 
required by $UPDATE must be passed to it by means of the PARM 
command of $JOBUTIL. The required information consists of: 

1. The name of the device to receive the printed output 
resulting from $UPDATE execution 

2. The name, volume of the data set containing the input object 
module 

3. The name, volume of the data set to contain the output 
loadable program 

^. An optional parameter YES if the output module is to 
replace an existing module of the same name, volume 

The volume names of the data sets must be given unless they 
reside on the IPL volume. 

The first three items of information are required and must be 
given in the order described. At least one blank must occur 
between each of these four items in the PARM command. 

An example of invoking $UPDATE via $JOBUTIL commands follows: 
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• 










♦ 

PROGRAM 
PARM 
NOMSG 
EXEC 


$UPDATE 
$SYSPRTR 


0BJM0D,V0L1 


MYPROG 


YES 


« 











In this example* $SYSPRTR receives the printed messages* the 
input object mociule is OBJMOD on V0L1» the output program is 
MYPROG on the IPL volume. If MYPROG already exists on the IPL 
volume it is replaced by the new version. If MYPROG does not 
already exist then space is allocated for it by $UPDATE. 
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Invoking $UPDATE Using the Session Manager 



To invoke ^UPDATE using the session manager, select option 6 
from the program preparation secondary option menu. 

The following parameter selection menu is displayed for entry 
of the required data sets and other parameters. The example 
shows the object program in the data set ASMOBJ is to be format- 
ted and placed in the data set TSTPGM. The REPLACE parameter is 
left blank when a member does not already exist. If the member 
did exist* that parameter should be entered as YES. 



$SMM0206: SESSION MANAGER $UPDATE PARAMETER INPUT MENU - 
ENTER/SELECT PARAMETERS: DEPRESS PF3 TO RETURN 



OBJECT INPUT (NAME, VOLUME) =============> ASMOBJ, EDX002 

PROGRAM OUTPUT ( NAME , VOLUME ) = = = = = = = = = = =: = > TSTPGM, EDX003 

REPLACE (ENTER YES IF PROGRAM EXISTS) ===> 
LISTING (TERMINAL NAME/3f) = = = = = = = = = = > $SYSPRTR 



/f 



Note : The object input, program output, and listing terminal 
name must be entered. An '^' indicates the listing will be dis- 
played on the terminal you are currently assigned to. 
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Creating a Supervisor 



The name $EDXNUC for the output program receives special treat- 
ment by $UPDATE since the creation of a supervisor results in 
an absolute, rather than a relocatable program. The following 
rules apply: 



1. If the first seven characters of the output program name 
are $EDXNUC then an absolute supervisor program will be 
formatted . 



2. 



If the eighth character of the name is either a blank or is 
not present, then the output program will automatically 
replace the existing supervisor program on the specified 
vo lume . 



3. If the eighth character of the program name is any charac- 
ter except a blank» then the output supervisor program will 
be stored in the library on the specified volume using the 
eight character name. 






In this manner* you can create multiple supervisor programs for 
different machine configurations on one Series/1. You can then 
copy them to tlie diskettes which can be used on the Series/1 
having the proper configuration. 

Supervisors created and stored under 8-character names (e.g., 
$EDXNUC2, $EDXNUCX, etc.) can be tested by: 

1. Copying the member into $EDXNUC on the IPL volume, and IPL 
the system again, or by 

2. Providing the CT5 address of the stored supervisor in 
response to the Stand Alone Utilities IPL message: 



'EXEC=' . 
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SUPDATEH - OBJECT PROGRAM CONVERTER (HOST) 



$UPDATEH transfers* over a communications link, Series/1 
object programs that are members of a host partitioned data set 
(PDS) and stores them in a Series/1 disk or diskette volume in 
the proper format to be loaded for execution. These programs 
were previously assembled on the host. To change the name of 
the default host library, locate the label, HOSTNAME, in the 
$UPDATEH listing and change the name from the supplied default 
library name to the host library name desired by you. $UPDATEH 
must then be assembled and installed in the program library. 

$UPDATEH requires that the Event Driven Executive Host Commu- 
nication Facility (lUP 5796-PGH) be installed on the host com- 
puter . 

$UPDATEH can be invoked either by the $L command, by the batch 
job stream processor ($JOBUTIL), or by the session manager. 
When invoked, $UPDATE prompts you for the information it 
requires. Examples of this interactive usage follow. 



$UPDATEH Commands 



The commands available under $UPDATEH are listed below. To dis- 
play this list at your terminal, enter a question mark in 
response to the prompting message COMMAND (?)*.. 






COMMAND (?): ? 



CH 
CV 
RP 
EN 



Change Host Library 
Change Series/1 Library 
Read a Program 
End $UPDATEH 



COMMAND (?): 



After the commands are displayed, you are again prompted with 
COMMAND (?): to which you respond with the command symbol for 
the function of your choice (for example, CH). 
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Examples 

Transfer of a New Program 



> $L 

PGMCNAME, VOLUME) : $UPDATEH 

$UPDATEH 23P, 15.29.59, LP = '^<^00 

THE DEFINED HOST LIBRARY IS SI . EDX . LOADL IB , OK? Y 

THE DEFINED VOLUME IS EDXOOl, OK? Y 

COMMAND (?): RP 

PGM name: TPTEST 
TPTEST STORED 

COMMAND (?): 



c 



Request Nonexistent Program 



COMMAND (?): RP 

PGM NAME : DUMMY 
DUMMY IS UNKNOWN 
COMMAND (?): 



Transfer and Replace Existing Program 



COMMAND (?): RP 

PGM name: PROGl 
PROGl REPLACE? Y 
PROGl STORED 

COMMAND (?): 
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T ransfer and Rename an Existing Program ? This example trans- 
fers an existing program^ PF?0G1> and renames it PR0G2. The 
existing program is not replaced. 



c 



COMMANDC?): RP 

PGM NAME: PROGl 
PROGl REPL? N 
RENAME? Y 

PROG NAME: PR0G2 
PR0G2 STORED 

COMMAND (?): 



Ch ange Host Library 



COMMAND (?): CH 

ENTER HOST LIBRARY NAME: SI . EDX. L0ADLIB2 

COMMAND (?): EN 

$UPDATE ENDED 15.30.5^ 



i ) 
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Messages and Codes 



CHAPTER 6. MESSAGES AND CODES 



This chapter contains messages and codes issued by the Event 
Driven Executive system. 



SYSTEM OPERATION MESSAGES 



IPL Operation 



The supervisor can be IPLed from the 4962 or 4963 disk or the 
4964 or 4966 diskette. The IPL switches on the Series/1 opera- 
tor console must be in the appropriate position for the type of 
IPL and the $SYSLOG terminal should be turned on. For example* 
if DISK is used to IPL, the IPL switch must be set to PRIMARY if 
the DISK is wired as the primary IPL device or to SECONDARY if 
the DISK is wired as a secondary IPL device. 






After IPL, the following message appears on the $SYSLOG termi- 
nal : 
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Volume Ini tiaXization 



The supervisor bhen attempts to 
disk/diskette volumes and prints 
the following: 



read each of the defined 
a status message similar to 



VOLSER 


TYPE 


lODA 


STATUS 


EDXOOl 


PRI. 


0002 


ONLINE 


EDX002 


PRI. 


0003 


ONLINE (IPL) 


SUPLIB 


SEC. 


0003 




MACLIB 


SEC. 


0003 






PRI. 


0012 


UNUSABLE 


EDX013 


PRI. 


0013 


ONLINE 



Note: This information can be displayed again by using the 
$IOTEST uti lity. 



VOLSER The volume identification for the disk/diskette or the 
name of a volume on a disk or diskette. 

TYPE If pr i mary, VOLSER is the volume identification of the 
d i sk/d i skette . 






If secondary , VOLSER is the name of defined volume on the 
dev i ce . 



lODA 



The hardware device address. 



STATUS The status of the hardware device. 

If a diskette was not inserted in a defined 4964 drive* the 
STATUS is UNUSABLE and the volume identification for the lODA 
is blank. If a diskette is subsequently put into the drive* it 
will be considered OFFLINE until a $VARYON command is 
performed. If the diskette contains a nonstandard label* the 
STATUS is marked OFFLINE. 

During IPL» the system initializes the 4966 Diskette Magazine 
Unit by reading the diskette label on each diskette. The 
diskettes are read in the following order: 

1. The diskettes in individual diskette slots 1 through 3 are 
read until all three are read or an empty slot is found 
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2. The diskettes in diskette magazine A are read until all ten 
are read or an empty slot is found 



3. The diskettes in diskette magazine B are read until all ten 
are read or an empty slot is found 

Each diskette read that contains a valid label is marked 
ONLINE. All others are marked OFFLINE. 

If the device is not turned on or has a hardware failure* the 
STATUS is marked UNUSABLE. 



I Tape Initialization 



Tape initialization is performed after volume initialization. 
The supervisor attempts to read each tape address* as defined 
at system generation. If the address is valid* the tape is 
marked OFFLINE and is therefore usable. A message is issued for 
each valid tape address similar to the following? 



"•^V 



TAPE 004C 
TAPE OO'hD 



OFFLINE 
OFFLINE 



If an address is incorrectly defined (for example* the device 
is not a tape)* if the tape drive is not turned on* or if the 
tape drive has a hardware failure* messages describing the 
problem are issued. Examples of messages areJ 



TAPE 004C IS NOT A TAPE ^ ^ * 
TAPE OO^C MARKED UNUSABLE 



Storage Map Generation 



At this point* the storage map for the supervisor is printed. 
If 6^K or less storage is available* one partition is available 
for your programs. If more than 64K is available and the 
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address translator feature is installed* multiple partitions 
can be defined as described in the system configuration state- 
ment SYSTEM. The starting address and size of each partition is 
printed as shown in the following example? 



\ ,y 



STORAGE MAP 
PART # START 



SIZE 



1 30720 34816 

2 65536 34816 

3 100352 30720 



The supervisor occupies the first 30720 bytes of storage. Three 
partitions are available for your programs. Partitions 1 and 2 
are 34816 bytes long» and partition 3 is 30720 bytes long. 



Load Utility Location 



At this point» the system locates the load utility program* 
^LOADER. If it cannot be found on the IPL volume* the following 
message is printed? 



X ""X 



'"^W-.^ 



NO PROGRAM LOAD FACILITY 



Sensor I/O Status Check 



The system also checks the status of any defined sensor I/O or 
Binary Synchronous Communications Adapter devices and prints 
appropriate status messages* for example; 



y 
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SENSOR I/O DEVICE AT ADDRESS 0050 IS OFFLINE 
BSCA NOT THE DEVICE AT ADDR : 0019 



Date and Time Printing 



If timer support was included during system generation* the 
system prints a message indicating that the date and time can 
be optionally entered (or reset) using the $T supervisor utili- 
ty: 



SET DATE AND TIME USING COMMAND $T 



If a system has been defined to include fixed head support for 
the <^962> a period of about 10 seconds will elapse before the 
*Set Date....' message appears. During this time» the fixed 
head portion of the disk is being initialized. 

Normally you enter date and time at IPL time; however, if the 
system started as a result of an AUTO IPL» the date and time can 
be entered later. 

The supervisor is now ready for operation. 



Program Load Message 



Any program invoked using $L (Load a Program) results in the 
following message being displayed, indicating that tfie program 
you requested has been loaded. 



PROGRAM 15P,1'^.00.35,LP = '^C00 
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Here* 15P indicates that the program is 15 pages long» where 
256 bytes equals one page. 14.00.35 is the time in hours* min- 
utes* and seconds. LP = '^COO indicates that the load point of the 
program is at location X'^COO". If timer support is not 
included in the supervisor, the time is not printed. 
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ERROR MESSAGES 



Program Check Error Message 

If a program check occurs during execution of a program* a mes 
sage with the following format is printed on the loading termi 
nal : 







PLP The program load point of the failing program. 

TCB The location of the task control block for the failing 
program (the address appearing on the assembly listing). 

PSN The processor status word when the check occurred 
(described later in this chapter). 

j LSB Level status block* consisting of the following: 



WORD 1 
WORD 2 
WORD 3 
WORD ^ 



- 11 



-- instruction address register (lAR) 

- address key register (AKR) 
~ level status register (LSR) 

- general registers (R0-R7) 



If the program is written is assembler language, COBOL, 
FORTRAN, or PL/I, the contents of the registers depend upon the 
conventions unique to that language. If the program is written 
in Event Driven Language, registers through 7 (words ^-11) 
conta i n : 
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WORD 


4 - 


- (RO) 


WORD 


5 - 


- (Rl) 


WORD 


6 - 


- (R2) 


WORD 


7 - 


- (R3) 


WORD 


8 - 


- (R^) 


WORD 


9 - 


- (R5) 


WORD 


10 - 


- (R6) 


WORD 


11 - 


- (R7) 



work register 

address of Event Driven Executive 

instruction 

address of EpL TCB 

address of EDL operand 1 

address of EDL operand 2 

EDL command 

work reg \ ster 

work register 



o 



The program in which the error occurred is either aborted or» 
if it has a task error exit> the exit is entered. In either 
case» normal system execution is resumed after the program 
check message has been printed. 



■K.j^ 
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System Program Check Error Message 



If a program check occurs in the supervisor* the following mes 
sage prints on the §SYSLOG terminal: 



SYSTEM PGM CHKJ PSW AND LSB 

8000 0000 101^ 80DP 6F00 6F22 1015 54F5 6F26 805C 



where J 

WORD 1 

NORD 2 

WORD 3 

WORD <i 



11 



- processor status word (PSW) 

- instruction address register (lAR) 

- address key register (AKR) 

- level status register (LSR) 
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Processor Status Word (PSW) 



Processor 

Type <»95x 

Bit 2 3 5 



Condi tion 



Class 
Interrupt 



Note 



00 X X X Specification Check 

01 X X X Invalid Storage Addr 

02 X X X Privilege Violate 

03 X X Protect Check 

X Not Used 

04 X X X Invalid Function 



05 X Floating Point 

Except i on 

X X Not Used 

06 X X X Stack Exception 

07 - - - Not Used 

08 X X X Storage Parity Check 

09 - - - Not Used 

10 X X X CPU Control Check 

11 X X X I/O Check 

12 X X X Sequence Indicator 

13 X X X Auto IPL 

14 X X Translator Enabled 

X Not Used 

15 X X X Power/Thermal Warning 



Program Check 

Program Check 

Program Check 

Program Check 



Soft Exception 

Trap 

Soft Except i on 

Trap 

Soft Except i on 
Trap 

Machine Check 

Machine Check 

Machine Check 

None 

None 

None 

Power/Therma 1 



Notes i 

1 . Always Zero 

2 . Status Flag 

3. Controlled by summary mask 



%y 



c 



y 
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$DUMP Error Messages 



Error messages may appear when the $DUMP utility is active. 

The following error message occurs if the data on the data set 
to be dumped is not the output of $TRAPJ 



dsname ON dsvol DOES NOT CONTAIN $TRAP OUTPUT 
$DUMP TERMINATED 



where dsname and dsvol are the names of the data set and the 
volume in which it resides used as input to $DUMP. 

The following error message occurs if an invalid partition 
number is entered during a partial storage dump: 



PARTITION NUMBER IS INVALID 



The following error message occurs if an invalid starting or 
ending storage address is entered during a partial storage 
dump : 



DUMP RANGE INVALID 

VALID RANGE IS xxxx TO yyyy 



where xxxx and yyyy are the valid range of storage addresses. 
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$LOG Error Message 



The following error message occurs if the error log becomes 
full : 



$LOG - ^^^ INSUFFICIENT BUFFERS FOR LOG RATE ^^^ 






c 



J 
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$RMU Error Messages 



The following error messages are issued when the Remote Manage- 
ment Utility encounters an error and are written to the termi- 
nal that loaded the utility. 



I $RMU Error 1 



The size of the buffer defined for use by the utility is less 
than the 512-byte minimum. The default 1024-byte buffer size 
has been modified incorrectly. 



$RMU ERROR 1 - INSUFFICIENT BUFFER. SIZE: nnnn 



I $RMU Error 2 



^F""^l!i 



The OPEN of the BSC communications line failed. The return code 
is defined in the description of the BSC Access Method for the 
Event Driven Executive. 



$RMU ERROR 2 - 



COMMUNICATIONS OPEN FAILED, 
RETURN CODE: nnnn 



I $RMU Error 3 



The CLOSE of a BSC communications line failed. The return code 
is defined in the description of the BSC Access Method for the 
Event Driven Executive. 



$RMU ERROR 3 - 



COMMUNICATIONS CLOSE FAILED, 
RETURN CODE: nnnn 
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$RMU Error 4 

A communications error has been detected by the utility. The 
I/O function (aaaaaa) indicates the type of request as follows: 

READ INITIAL 
READ CONTINUE 
WRITE EOT 
WRITE INITIAL 
WRITE EOT (ABORT) 
WRITE CONTINUE 

The return code is defined in the description of the BSC Access 
Method for the Event Driven Executive. 



$RMU ERROR ^ 



COMMUNICATIONS I/O ERROR. 
I/O FUNCTION: aaaaaa 
RETURN CODE: nnnn 



I $RMU Error 5 



The utility attempted to load an overlay program via a LOAD 
instruction* and the load failed. The return code is issued for 
the LOAD instruction. 



'\..-j^ 



$RMU ERROR 5 - 



LOAD OVERLAY FAILED, RETURN CODE: nnnn 
OVERLAY NUMBER: mmmm 



$RMU Error 6 

The utility's function table defined a function as being con- 
tained within an overlay, but it was not. Thiserror can occur 
if a user-written function is not added properly to the func- 
tiontable. 



$RMU ERROR 6 - 



OVERLAY FUNCTION MISSING. FUNCTION: nnnn 
OVERLAY NUMBER: mmmm 



4' 
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$TRAP Error Messages 



Error messages may appear when the $TRAP utility is active. 

The following error message occurs if $TRAP is loaded into a 
partition other than partition IJ 



$TRAP MUST BE IN PARTITION *1 
$TRAP TERMINATED 



The following error message occurs if the data set assigned to 
$TRAP is not large enough to contain the amount of storage 
be i ng saved ' 



dsname ON dsvol IS ONLY xxx RECORDS. MINIMUM SIZE IS yyy 

RECORDS 

$TRAP TERMINATED 



The following error message occurs if no trap conditions have 
been specified: 



NO TRAP CONDITIONS 
$TRAP TERMINATED 



SPECIFIED 
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UTILITY COMPLETION CODES 



The utility completion codes are printed on the list device by 
the utility programs upon their completion unless otherwise 
noted . 



SEDXASM Completion Codes 



$EDXASM completion codes are accompanied by an appropriate 
error message. The completion codes can be tested by the job 
stream processor* allowing steps subsequent to the assembly to 
be skipped; if appropriate* The completion codes are: 



Completion Conditions 



Completion Code 



Successful completion - 
no errors in assembly. 

Successful completion - 
one or more statements had 
assembly errors. 

Out of space in work or object 
data set. 

I/O error in source» work» or 
object data set. 

Overlay-instruction table full. 

Unable to locate overlay 
program or copy code module. 

Operator cancelled assembly 
with ATTN CA command. 



8 

12 

12 
12 

12 

100 



^^. 
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$IAMUT1 Completion Codes 



CODE 



DESCRIPTION 



1 

01 

02 

03 

0^ 

05 

06 

07 

08 

12 

13 

23 

31 

32 

33 

3«^ 
36 

37 
38 
39 
^0 
^1 
A2 
^^3 
^^ 
^5 
^6 
47 
«^8 
49 
50 
51 
52 

54 
55 



1 n load modu le 
lACB 



Successful completion 

Data set not found (OPEN failed) 

Invalid lODA exit (OPEN failed) 

Volume not mounted (OPEN failed) 

Library not found (OPEN failed) 

Disk I/O error (OPEN failed) 

No VTOC exit address (OPEN failed) 

L i nk module i n use 

Load error for $IAM 

Data set shut down 

Module not included 

Get storage error - 

FOB WRITE error during IDEF processing 

Blocksize not multiple of 256 

Data set is greatr^r than 32,767 

Event Driven Executive records 

Data set is too small 

Invalid block size during file definition 

process i ng 

Invalid record size 

Invalid index size 

Record size greater than block 

In val 

In va 1 

Inval 

Inval 

In va 1 

Inval 

Inval 

Inval 

Inval 

Inval 



s 1 ze 

number of free records 

number of clusters 

key s i ze 

reserve index value 

reserve block value 

free pool va lue 

delete threshold value 

free block value 

number of base records 

key pos i t i on 
Data set is opened for exclusive use 
Data set opened in load mode 
Data set is opened, cannot be 
opened exclusively 

Invalid block size during PROCESS or LOAD 
Get storage for FOB error 
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CODE 



56 
60 

61 

62 

100 

101 

110 



DESCRIPTION 



FCB READ error 

LOAD mode key is equal to or less 

previous high key in data set 

End of file 

Duplicate key found 

READ error 

WRITE error 

WRITE error - data set closed 



than 



A,^_.y 



^k^.,u^ 
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SJOBUTIL Completion Codes 



The $JOBUTIL completion codes are displayed on the 
used to access $JOBUTIL. The codes are as follows. 



termi nal 






Code Description 



-1 
61 

6^ 
67 

70 
71 
72 

73 

74 
75 
76 
77 
78 

79 

80 



Succ 

The 

in t 

No 5 

A di 

the 

Not 

Prog 

Disk 

d i re 

Disk 

head 

Refe 

Ref e 

Data 

Inva 

LOAD 

set( 

LOAD 

para 

Inva 

grea 



essf 
t ran 
he 5 
pace 
sk o 
load 
enou 
ram 

or 
ctor 

or 
er 

renc 
renc 

set 
lid 

i ns 
s) 

i ns 
mete 
lid 
ter 



ul comp let ion 

sient loader ($LOADER) is not included 

ystem 

ava i lable for t 
r diskette I/O e 

process 
gh ma i n storage 
not found on the 
diskette I/O Brr 
y 
diskette I/O error while reading program 



he transient loader 
rror occurred during 

available for the program 

specified volume 
or while read i ng 



ed module is not 
ed module is not 
not found on re 
data set name 
truct ion did not 

tr uct ion did not 

volume label spe 
than e i ght chara 



a program 
a data set 
ferenced volume 

specify required data 

spec i f y requ i red 

cifiedj for example* 
cter s 
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$LINK Completion Codes 



Message 


Descr i pt i on 


Cause 


Act i on 


Return 


number 




code 


code 


code 


— 


Successful completion 


— 


_ 


-1 


01 


DS2 less than 265 records 


1 


2 


12 


02 


Disk error reading DSl 


2 


2 


12 


03 


End of file reached on DSl 


1 


3 


4 


0^ 


Disk error reading object 










module 


2 


1 


8 


05 


Invalid 'OUTPUT' record 


1 


2 


12 


06 


Invalid 'INCLUDE' record 


1 


6 


8 


07 


Error opening object output 










module : 


1 


5 


12 




- misspelled name or 










vol ume 










- data set not allocated 








08 


Error opening input object 










module (see Error 07) 


1 


6 


8 


09 


Error opening output module 
(hardware error) 


2 


5 


12 


10 


Error opening an input 
module (hardware error) 


2 


6 


8 


11 


Error opening autocall list 
(DS9). See Error 07 for 










causes 


1 


5 


12 


12 


Error opening autocall list 










(DS9) (hardware error) 


2 


5 


12 


13 


Invalid input object module 










record type 


4 


4 


8 


14 


Entry point label not found 


1 


3 


4 


15 


No valid ESDID for TXT or 










RLD 


4 


4 


8 


16 


Invalid ESD item type 


4 


4 


8 


17 


Duplicate ESDID number 


4 


4 


8 


18 


Inval i d Symbol 


4 


4 


8 


19 


Duplicate Entry point 










symbol 


3 


4 


8 


20 


Invalid ESDID number 


4 


4 


8 


22 


Invalid ESD symbol 


4 


1 


8 


23 


End of file reached on DS9 


1 


2 


12 


24 


Disk error reading DS9 


2 


2 


12 



1 



o 
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^^^ 

\^/ 



Message 


Description 


Cause 


Action 


Return 


n umber 




code 


code 


code 


25 


Disk error reading DS4 


2 


2 


12 


26 


End of File reached on DS3 


6 


2 


12 


27 


Disk error Read /Write 










on DS8 


2 


2 


12 


28 


End of file reached on DS8 


5 


2 


12 


29 


End of file reached on DS7 


6 


2 


12 


30 


End of file reached on DS4 


6 


2 


12 


31 


Disk error writing on DS5 


2 


2 


12 


32 


End of file reached on DS5 


5 


2 


12 


33 


End of file reached on DS2 


6 


2 


12 


34 


Duplicate section definition 










(CSECT) 


3 


1 


4 


36 


End of file reached on DS6 


4 


1 


8 


37 


Disk error* read/write on 










DS7 


2 


2 


12 


38 


Disk error, read/write on 










DS3 


2 


2 


12 


39 


Invalid RLD record data 










length 


4 


4 


8 


40 


Disk error, read/write on 










DS2 


2 


2 


12 


42 


DS2 not large enough 










(program size over 64K) 


5 


2 


12 


45 


No "INCLUDE' records 


1 


2 


12 


4 6 


No CSECT length field 


4 


3 


4 


None 


Unresolved EXTRN 






4 
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C ause Co d e s 



Your error 

System error 

Possible duplicate ' name » vo lume * or duplicate CSECT 

or ENTRY names 

Input object record(s) in error. Probable cause is 

that * name » volume * is not a valid object module 

Data set is of insufficient size 

Probable $LINK error, this condition should not 

occur 



Action Codes 

1 - Log warning message and continue at next 'INCLUDE' 

2 - Terminate $LINK with error message 

3 - Continue as if expected occurance had happened 
^ - Log error message plus invalid object module 

record and continue at next 'INCLUDE' 

5 - Log error message plus OUTPUT record and 

terminate $LINK 

6 - Log error message plus INCLUDE record, continue 

at next 'INCLUDE' 



Return Code Definitions 

-1 Successful completion 
4 Warning: A module has been written 

execution will probably work 
8 Warning: A module has been written 
execution will probably fail 
12 Severe error: Module is not written 
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SUPDATE Completion Codes 



The $UPDATE completion codes are displayed on the terminal used 
to access $UPDATE. The codes are as follows. 



o 



Code 



-1 
8 
8 
8 
8 
8 
8 
8 
8 
8 
8 
8 
8 
8 
8 

12 



Cond i t i on 



Successful completion 

No supervisor space in this library 

Output name specified is not a program 

Disk volume already in use by another program 

No space in directory 

No space in data set (output library) 

Invalid header format 

Invalid program name 

Disk volume not mounted 

Disk volume off line 

Library not found 

Input data set not found 

No parameter supplied via $JOBUTIL 

No data set names provided via $JOBUTIL 

Replacement of output data set not allowed 

Any disk or diskette I/O errors 
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EVENT DRIVEN LANGUAGE AND FUNCTION RETURN CODES 



The Event Driven Language return codes are returned in the 
first word of the Task Control Block of the program which 
invoked the respective language instruction or function unless 
otherwise noted. 



$DISKUT3 Return Codes 



The $DISKUT3 utility places a return code 
the DSCB specified. The return codes for 
be low . 



in the first word of 
$DISKUT3 are listed 




10 
11 

12 

13 
1^ 
15 
16 
17 

18 

19 
20 
21 



In va 

Volu 

Insu 

Insu 

Data 

requ 

Insu 

Disa 

$EDX 

Data 

(DEL 

New 

Disk 

(ALL 

I/O 

(ALL 

I/O 

Data 

In va 

In va 

M i sm 

(DEL 

Data 

requ 

SETE 

Load 

Tape 



lid r 
me do 
ff ici 
f f i c i 

set 
ested 
f f i c i 
1 lowe 
LIB ( 

set 
ETE, 
name 

is b 
OCATE 
error 
OCATE 
error 

set 
lid 5 
lid s 
atche 
ETE, 

set 
ested 
OD on 

of $ 

data 



equest c 
es not e 
ent spac 
ent spac 
already 

a 1 locat 
ent c o n t 
d data s 
All f unc 
not foun 
OPEN, RE 
po i nter 
usy 
, DELETE 

writing 
, DELETE 

reading 
name is 
i ze spec 
i ze spec 
d data s 
OPEN, RE 
already 

al locat 
1 y valid 
DISKUT3 

sets ar 



ode 
X i s 
e i 
e i 
ex i 
i on 
i gu 
et 
t i o 
d 

LEA 
i s 



parameter (not 1-5) 
t (All f unct i ons ) 
n library (ALLOCATE) 
n directory (ALLOCATE) 
sts - smaller than the 



ous space 
name, eg. 
ns) 



(ALLOCATE) 
$EDXVOL or 



SE, RENAME) 
zero (RENAME) 



RENAME) 

RENAME) 

(All f unct i ons ) 
(ALLOCATE, RENAME) 
(ALLOCATE) 



, RELEASE, 

to disk 
, RELEASE, 

from disk 
all blanks 
i f i cat i on 
ification (RELEASE) 
et type 

LEASE, RENAME) 
exists - larger than the 
i on 

for data set of type *data' 
failed ($RMU only) 
e not supported 
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$PDS Return Codes 



Use the EVENT = par ameter on the LOAD command when using the $PDS 
utility. The $PDS utility returns the status of the request in 
the Event Control block specified in the LOAD command. The 
return codes for $PDS are listed beloM. 



Code 



Cond i t i on 



-1 
1 
2 
3 

5 
7 

a 

9 
10 



Successful operation 

Member not found 

Member already allocated 

No space 

Di rectory is full 

Member was not used 

Record not in member 

Member control block invalid 

Space not released 

Not a data member 
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BSC Return Codes 



Code 



-2 

-1 



END = 

1 
2 
3 

5 
6 



ERROR= 

10 
11 
12 
13 
1^ 
15 
20 
21 
22 
23 
24 
25 
30 
31 
32 
33 
34 

35 
99 



Descr i pt i on 



Notes 



Text received in conversational 
Successful completion 



mode 



EOT rece i ved 

DLE EOT received 

Reverse interrupt received 

Forward abort received 

Remote station not ready (NAK received) 

Remote station busy (WACK received) 



Ti meout 
Unreco V 
Invalid 
Invalid 
Di srega 
Remote 
Wrong 1 
Nrong 1 
Invalid 
Buffer 
U n d e f i n 
Line no 
Modem i 
Hardwar 
Hardwar 
U n e X p e c 
Inval i d 
attempt 
Enable 
Access 



occurred 
ered transmission error (BCC error) 

sequence received 

mult i -point tributary write attempt 
rd this block sequence received 
station busy (WACK received) 
ength record - long (No COD) 
ength record - short (write only) 

buffer address 
length zero 
ed line address 
t opened by calling task 
nterface error 
e over run 
e error 
ted ring interrupt 

interrupt during auto-answer 



or disable DTR 
method error 



error 



'A a/ 



Notes : 

1. Retried up to the limit specified in the RETRIES= operand 
of the BSCLINE definition. 
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2 . Not retr t ed . 

3. Retried during write operation only when a wrong ACK is 
received following an ENQ request after timeout (indicat- 
ing that no text had been received at the remote station). 

^. Returned only during an initial sequence with no retry 
attempted . 

5. Retried only after an unsuccessful start I/O attempt. 

6. Retried only during read operations. 



Data Formatting Return Codies 



m^ 



Code Description 



1 Successful completion 

1 No data in field 

2 F i eld omi tted 

3 Conversion error 
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EXIO Return Codes 



1 ') 



I/O Instruction Return Codes (word 
(Word 1 of TCB contains supervisor 
address) 



of TCB) 
instruction 



Code Descr i pt i on 



-1 Command accepted 

1 Device not attached 

2 Busy 

3 Busy after reset 
^i Command reject 

5 Intervention required 

6 Interface data check 

7 Controller busy 

8 Channel command not allowed 

9 No DDB found 

10 Too many DCBs chained 

11 No address specified for residual status 

12 EXIODEV specified zero bytes for residual status 

13 Broken DCB chain (program error) 
16 Device already opened 



( 1 



<+48 SC3^-0313 



\^^ 



Return Codes 



Interrupt Condition Codes (Bits ^-7 of word 
(If bit is on, bits 8-15=device ID) 



of ECB) 



Code Desc r i pt i on 





1 

2 

3 

^ 

5 

6 

7 

8 

9 

10 

11 

12 

13 

15 



(PCI) 



and 
and 
and 



PCI 

exception 
device end 



Controller end 

Program Controlled Interrupt 

Exception 

Device end 

Attention 

Attention 

Attention 

Attention 

Not used 

Not used 

SE on and 

SE on and 

SE on and 

status 

Broken DCB chain 

ECB to be posted not reset 

Error in Start Cycle Steal Status 

(after exception) 



too many DCBs chained 

no address specified for residual status 

EXIODEV specified no bytes for residual 
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Floating Point Return Codes 






Code Description 



1 Successful completion 

1 Floating point overflow 

3 Floating point divide check 

(divide by *0') 
5 Floating point under flow 



Formatted Screen Image Return Codes 



These return codes are issued by the $IMOPEN subroutine. They 
are returned in the second word of the Task Control Block of the 
calling program . 



'\^-.y 



Code Description 



-1 Successful completion 

1 Disk I/O error 

2 Invalid data set name 

3 Data set not found 

^ Incorrect header or data set length 

5 Input buffer too small 
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Indexed Access Method Return Codes 



CODE 



DESCRIPTION 



1 


Success f ul 


57 


Data set ha 


58 


Record not 


80 


End of data 


85 


Record to b 


01 


Function co 


07 


L i nk module 


08 


Load error 


10 


Inva 1 Id req 


12 


Data set sh 


13 


Modu le not 


22 


Invalid lAC 


23 


Get storage 


50 


Data set is 




use» cannot 


51 


Data set op 


52 


Data set is 




opened excl 


54 


Invalid bio 




process i ng 


55 


Get storage 


56 


READ error 


60 


Out of sequ 


61 


End of file 


62 


Duplicate k 


70 


No space fo 


80 


FCB WRITE e 


85 


Key field m 


90 


Key save ar 


100 


READ error 


101 


WRITE error 


110 


WRITE error 



completion 

s been loaded 

found 

e deleted not found 
de not recognized 

i n use 
for $IAM 
uest 

ut down due to error 
included in load module 
B address 

error - lACB 

opened for exclusive 

be opened exclusively 
ened in load mode 

opened* cannot be 
us i ve ly 
ck size during PROCESS or LOAD 

error - FCB 
- FCB 
ence or duplicate key 

ey found in PROCESS mode 

r i nsert 

rror during DELETE processing 

od i f i ed by user 

e a in use 



data set closed 
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LOAD Return Codes 



Code Description 



"1 
61 

62 
63 
64 
65 



66 

67 

68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 

79 

80 
81 

82 



Succe 
The t 
in th 



In 
In 
No 
In 



an 
an 
sp 
an 



sets 

the n 

In an 

passe 

A dis 

proce 

Reser 

Reser 

Not e 

Progr 

DiskC 

Di sk( 

Refer 

Refer 

Data 

Inval 

LOAD 

set (s 

LOAD 

p a r a m 

Inval 

Cross 

not i 

Reque 

parti 



ssf u 1 
r a n s i 
e sys 

over 

over 
ace a 

over 
passe 
umber 

over 
d to 
k(ett 
ss 
ved 
ved 
n o u g h 
am no 
ette) 
ette) 
enced 
enced 
set n 
id da 
i nstr 
) 

i nstr 
eters 
i d vo 

part 
nc lud 
sted 
t i o n s 



complet i on 
ent loader ($LOADER) is not included 
tem 

lay request* no overlay area exists 
lay request* the overlay area is in use 
vailable for the transient loader 
lay load operation* the number of data 
d by the LOAD instruction does not equal 

required by the overlay program 
lay load operation* no parameters were 
the loaded program 
e) I/O error occurred during the load 



main storage available for the program 
t found on the specified volume 

I/O error while reading directory 

I/O error while reading program header 

module is not a program 

module is not a data set 
ot found on referenced volume 
ta set name 
uction did not specify required data 

uction did not specify required 
(s) 

lume label specified 
ition LOAD requested* support 
ed at system generation 

partition number greater than number of 
in the system 



'^>' 



Note : If the program being loaded is a sensor I/O program and a 
sensor I/O error is detected* the return code will be a sensor 
I/O return code* not a load return code. 
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Return Codes 



Multiple Terminal Manager Return Codes 



These return codes are returned in a caller-specified variable 
on the SETPAN or FILEIO function. 



CODE 



DESCRIPTION 



-1 


Successf 


1 


Warn i ng : 




has been 




and curs 


2 


Data tab 


201 


Data set 


202 


Volume n 


203 


No file 




all have 


204 


I/O erro 


205 


I/O erro 


206 


Invalid 


207 


Invalid 


208 


SEOD rec 




length 


-500 


Termi nal 




No act i 


-501 


Screen d 


other 


Return c 




Indexed 



ul comp let i on 

uninitialized panel. Input buffer 

set to unprotected blanks Cx'OO') 
or position set to zero, 
le truncated. 

not found 
ot found 
table entries are available; 

updates outstanding 
r reading volume directory 
r writing volume directory 
function request 
key operator 
ord number greater than data set 

is not an IBM A978/'J»979. 
n has been taken 
ata set not found, 
ode from READ/WRITE or the 
Access Method 
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Return Codes 



READ/WRITE Return Codes 



Disk /tape return codes resulting from READ/WRITE instructions 
are returned in two places? 



1. The Event Control Block (ECB) named DSn, 
number of the data set being referenced. 



where n is the 



2, The task code word referred to by taskname. 

The disk /tape return codes and their meanings are shown below. 

If further information concerning an error is required* it may 
be obtained by printing all or part of the contents of the Disk 
Data Blocks (DDBs) located in the Supervisor. The starting 
address of the DDBs can be obtained from the linkage editor map 
of the supervisor. The contents of the DDBs are described in 
the Internal Design . Of particular value are the Cycle Steal 
Status Words and the Interrupt Status Word save areas* along 
with the contents of the word that contains the address of the 
next DDB in storage. 
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Return Codes 



Disk Return Codes 






Code Description 



-1 Successful completion 

1 I/O error and no device 
(this code may be caused 
at an odd byte address) 

2 I/O error trying to read 

3 I/O error retry count ex 
<f Error on issuing I/O ins 

status 

5 Unrecoverable I/O error 

6 Error on issuing I/O ins 

7 A "no record found' cond 
for an alternate sector 
*no record found* occurr 
assigned 

9 Device Mas 'offline' whe 

10 Record number out of ran 
end-of-file (data set) c 

11 Device marked 'unusable' 



status present 
by the I/O area starting 

de v i ce status 
hausted 
truction to read device 



truction for normal I/O 
ition occurred, a seek 
was performed, and another 
ed i.e., no alternate is 

n I/O was requested 
ge of data set--may be an 
o n d i t i o n 
when I/O was requested 
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Raturn Codes 



Ta pe Return Codes 



o 



Code Descr i pt i on 



~1 Successful completion 

1 Exception but no status 

2 Error reading STATUS 

^ Error issuing STATUS READ 

5 Unrecoverable I/O error 

6 Error issuing I/O command 
10 Tape mark (EOD) 

20 Device in use or offline 

21 Wrong length record 

22 Not ready 

23 File protect 

24 EOT 

25 Load po i nt 

26 Uncorrected I/O error 

27 Attempt WRITE to unexpired data set 

28 Invalid b Iks i ze 

29 Data set not open 

30 Incorrect device type 

31 Incorrect request type on close request 

32 Block count error during close 

33 EOVl label encountered during close 
76 DSN not found 
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Return Codes 



SBIO (Sensor-based I/O) Return Codes 



C, 



Code Description 



-1 Successful completion 

90 Device not attached 

91 Device busy or in exclusive use 

92 Busy after reset 

93 Command reject 
3^ Invalid request 

95 Interface data check 

96 Controller busy 

97 Analog Input over voltage 

98 Analog Input invalid range 

100 Analog Input invalid channel 

101 Invalid count field 

102 Buffer previously full or empty 
104 Delayed command reject 
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Return Codes 



Terminal I/O Return Codes 



c 



"\\ 



Code 



Bit 



Descr i pt i on 



-1 Successful completion 

1 Device not attached 

2 System error (busy condition) 

3 System error (busy after reset) 
^ System error (command reject) 

5 Device not ready 

6 Interface data check 

7 Overrun received 

11 Codes greater than 10 represent possible 

multiple errors. To determine the errors^ 
subtract 10 from the code and express the result 
as an 8~bit binary value. Each bit (numbering 
from the left) represents an error as followsJ 



Descr i pt i on 



Unused 

System error (command reject) 

Not used 

System error (DCB specification check) 

Storage data check 

Invalid storage address 

Storage protection check 

Interface data check 



\._y 



NoieJ If an error message code greater than 128 is returned for 
devices supported by I0S27<^1 (2741, PROC), subtract 128; the 
result then contains status word 1 of the ACCA. (Refer to 
Communicatio n Features Description to determine the special 
error cond i t i on . ) 



c 



y 
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Terminal I/O ~ ACCA Return Codes 



-1 



Successful completion. 



Bit 



Descr i pt i on 



Unused 

1-8 ISB of last operation (I/O complete) 

9-10 Unused 

11 1 if a write or control operation (I/O complete) 

12 Read operation (I/O complete) 

13 Unused 

14-15 Condition code +1 after I/O start (or) 
Condition code after I/O complete 
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Terminal I/O - Interprocessor Communications Return Codes 



o 



CODTYPE= 



EBCD/CRSP 



EBCDIC 



Return 
Codes 



End of Transmission (EOT). IF 
End of Record (NL). 5B 

End of Subrecord (EOSR). Not used. 



FDFF -2 
FEFF -1 
FCFF Handled 
by dev i ce 
support 



L, 
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Return Codes 



Terminal I/O - Virtual Terminal Communications Return Codes 



Value 



Tr ansm i t 



Rece i ve 



x'8Fnn' NA 
x'SEnn' NA 
-2 NA 

-1 Successful completion 

1 Not attached 

5 Disconnect 

8 Break 



L INE = nn rece i ved 
SKIP=nn received 
L i ne rece i ved ( no 
New 1 i ne rece i ved 
Not attached 
D i sconnect 
Break 



OR) 



LINE = nn (x*8Fnn' ) : This code is posted for READTEXT or GETVALUE 
instructions if the other side sent the LINE forms control 
operation; it is transmitted so that the receiving program may 
reproduce on a real terminal (for printer spooling applica- 
tions for example) the output format intended by the sending 
program . 

SKIP = nn ( X * 8Enn ' ) : The sending program transmitted SKIP = nn, 

L i ne Rece i ved (-2 ) : This code indicated that the sending pro- 
gram did not send a new line indication* but that the line was 
transmitted because of execution of a control operation or a 
transition to the read state. This is how* for example, a 
prompt message is usually transmitted with READTEXT or 
GETVALUE. 

New Line Received (-1) : This code indicates transmission of the 
carriage return at the end of the data. The distinction 
between a new line transmission and a simple line transmission 
is» again* made only to allow preservation of the original out- 
put format . 

Not attached (1) : If tfie virtual terminal accessed for the 
operation does not reference another virtual terminal, then 
this code is returned. 



o 



Disconnect (5) : This code value corresponds to the 'not ready' 
indication for real terminals; its specific meaning for vir- 
tual terminals is that the program at the other end of the chan- 
nel terminated either through PR06ST0P or operator 
i nter vent i on . 
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Break (8) t The break code indicates that the other side of the 
channel is in a state (transmit or receive) which is incompat- 
ible with the attempted operation. If only one end of the chan- 
nel is defined with SYNC=YES (on the TERMINAL statement), then 
the task on that end will always receive the break code, wheth- 
er or not it attempted the operation first. If both ends are 
defined with SYNC = YES, then the code will be posted to the task 
which last attempted the operation. The break code may thus be 
understood as follows: when reading (READTEXT or GETVALUE), 
the other program has stopped sending and is waiting for inputj 
when writing (PRINTEXT or PRINTNUM), the other program is also 
attempting to write. Note that current Event Driven Executive 
programs, or future programs which do not interpret the break 
code, must always communicate through a virtual terminal which 
is defined with SYNC=NO (the default). 



o 






O 
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Return Codes 



TP Return Codes 






Code 



Description 



Module 



6 

7 
8 

9 
10 

11 

50 
51 



Successful completion 

Illegal command sequence 

TP I/O error 

TP I/O error on host 

Looping bidding for the line 

Host acknowledgement to request 

code was neither ACKO , ACKl , WACK , 

or a NACK 

Retry count exhausted - last error 

was a timeout: the host must be down 

Looping while reading data from 

the host 

The host responded with other than 

an 'EOT' or an ' ENQ ' when an 'EOT' 

was expected 

Retry count exhausted - last error 

was a 'modem interface check' 

Retry count exhausted - last error 

was not a t i meout ^ modem 

block check or overrun 

Retry count exhausted - 

was a transmit overrun 

I/O error from last I/O in DSNRITE. 

I/O error when writing the last buffer 



check f 
last error 



Super V i sor 
Super V i sor 
Super V i sor 

HCFCOMM 
Super V i sor 
Super V i sor 



Super V i sor 
Super V i sor 
Super V i sor 

Superv 1 sor 
Supervisor 

Superv i sor 

DSCLOSE 
DSCLOSE 



100 Length of DSHAME is zero 

101 Length of DSNAME exceeds 52 

102 Invalid length specified for 



I/O 



HCFCOMM 
HCFCOMM 
HCFINIT 
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Return Codes 



-W 



Code 



200 

201 
202 
203 
20<+ 
205 
206 

207 
208 
209 
211 
212 
213 
21^+ 
216 

217 

218 
219 
220 

221 
222 



Descr i pt i on 



Module 



Data set not on volume specified for HCFINIT 

control ler 

Invalid member name specification DSOPEN 

Data set in use by another job DSOPEN 

Data set already allocated to this task DSOPEN 

Data set is not cataloged DSOPEN 

Data set resides on multiple volumes DSOPEN 

Data set is not on a direct access 

device DSOPEN 

Volume not mounted (archived) DSOPEN 

Device not online DSOPEN 

Data set does not exist DSOPEN 

Record format is not supported DSOPEN 

Invalid logical record length DSOPEN 

Invalid block size DSOPEN 

Data set has no extents DSOPEN 

Data set organization is partitioned and 

no member name was specified DSOPEN 

Data set organization is sequential and 

a member name was specified DSOPEN 

Error during OS/ OPEN DSOPEN 

The specified member was not found DSOPEN 

An I/O error occurred during a 

directory search DSOPEN 

Invalid data set organization DSOPEN 

Insufficient I/O buffer space available DSOPEN 



300 End of an input data set 

301 I/O error during an OS/ READ 

302 Input data set is not open 

303 A previous error has occurred 



DSREAD 
DSREAD 
DSREAD 
DSREAD 



'K...J' 
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Return Codes 



Code 



Descr i pt i on 



Module 



400 End of an output data set 

<+01 I/O error during an OS/ NRITE 

402 Output data set is not open 

403 A previous error has occurred 

404 Partitioned data set is full 



DSWRITE 
DSWRITE 
DSWRITE 
DSWRITE 
DSCLOSE 



700 IndeXf key» and status record added SET 

701 Index exists^ key and status added SET 

702 Index and key exist* status replaced SET 

703 Error-Indexfull SET 

704 Error - Data set full SET 
710 I/O Error SET 



.^' 



800 Index and key exist 

801 Index does not exist 

802 Key does not exist 
810 I/O error 



900 Index and/or key released 

901 Index does not exist 

902 Key does not exist 
910 I/O error 



Ixxx An error occurred in a subordinate 
module during SUBMIT. 'xxx' is 
the code returned by that module. 



FETCH 
FETCH 
FETCH 
FETCH 



RELEASE 
RELEASE 
RELEASE 
RELEASE 



S7SUBMIT 
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BIBLIOGRAPHY 



EVENT DRIVEN EXECUTIVE LIBRARY SUMMARY 



The library summary is a guide to the Event Driven Executive 
library. By briefly listing the content of each book and 
providing a suggested reading sequence for the library> it 
should assist you in using the library as a whole as well as 
direct you to the individual books you require. 



Event Driven Executive Library 



The IBM Series/1 Event Driven Executive library materials 
consist of five full-sized books* a quick reference pocket 
book, and a set of tabs: 



IBM Series/1 Event Driven Executive System Guide 


(or 


System Guide), SC3^-0312 




IBM Series/1 Event Driven Executive Utilities, Opers 


itor 


Commands, Proaram Preparation, Messaaes and Codes 


(or 


Uti lities), SC3^-0313 




IBM Series/1 Event Driven Executive Lanauaoe Reference 


(or 


Lanquaqe Reference), SC34-031<^ 




IBM Series/1 Event Driven Executive Communications 


and 



T erminal Application Guide (or Communications Guide ) , 
SC3'!f-0316 

IBM Series/1 Event Driven Executive Internal Design (or 
Internal Design ), LY34-0168 

IB M Series/1 Event Driven Executive Multiple Terminal Man- 
ag er Internal Design ( o r Multiple Terminal Manager 
Internal Design ), LY3^-0190 

IBM Seri e s/1 Event Driven Executive IndexedAccess Method 
Internal Design (or Indexed Access Method Internal 
De sign) , LY3<^-0189 

IBM Series/l Event Driven Executive Reference Summary (or 
Reference Summary ), SX34-0101 

IBM Series/l Event Driven Executive Tabs (or Tabs ) , 
SX3^-0030 



Bi bl 1 ography <^67 



Summary of Library 



System Guide 






The System 6u i de introduces the concepts and capabilities of 
the Event Driven Executive system. It discusses mult i -task i ng » 
program and task structure* program overlays* storage manage- 
ment* and data management. 

Planning aids include hardware and software requirements* 
along with guidelines for storage estimating. 

The S ystem Guide also presents step-by-step procedures for 
generating a supervisor tailored to your Series/1 hardware 
configuration and software needs. 

The description of the Indexed Access Method contains the 
information on how to write applications that use indexed data 
sets . 

The description of the session manager includes a procedure for 
modifying the session manager to include application programs 
in the primary option menu so that you can execute them under 
the session manager. You can also add a procedure to compile* 
link* and update programs. 

Information is also provided concerning partitioned data sets* 
tape data organization* diagnostic aids* inter-program commu- 
nication* logical screens* and dynamic data set allocation. 



^\^ 



Uti lities 

Utilities describes? 

• Event Driven Executive utility programs 

• Operator commands 

• Procedures to prepare and execute system and application 
programs 

• The session manager — a menu-driven interface program 
that will invoke the programs required for program devel- 
opment 

• Messages and codes issued by the Event Driven Executive 
system 
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The operator commands* program preparation facilities* and 
session manager are grouped by function and discussions 
include detailed syntax and explanations. The utilities are 
presented in alphabetical order. 



Language Reference 



The Language Reference familiarizes you with the Event Driven 
Language by first grouping the instructions into functional 
categories. Then the instructions are listed alphabetically* 
with complete syntax and an explanation of each operand. 

The final section of the Language Reference contains examples 
of using the Event Driven language for applications such as: 



Program load i ng 

User exit routine 

Graphics 

I/O level control program 

Indexing and hardware register usage 



Communications Guide 



The Cotnmunications Guide introduces the Event Driven Executive 
communications support -- binary synchronous communications* 
asynchronous communications* and the Host Communications 
Fac i 1 i ty . 

The Communications Guide contains coding details for all util- 
ities and Event Driven language instructions needed for commu- 
nications support and advanced terminal applications. 



Internal Design 



Internal Design describes the internal logic flow and specifi- 
cations of the Event Driven Executive system so that you can 
understand how the system interfaces with application pro- 
grams. It familiarizes you with the design and implementation 
by describing the purpose* function* and operation of the vari- 
ous Event Driven Executive system programs. 
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Multiple Terminal Manager Internal Pesic in and Indexed Access 
Method Internal Design describe the internal logic flow and 
specifications of these programs. 

Unlike the other manuals in the library* the Internal Design 
books contain material that is the licensed property of IBM and 
they are available only to licensed users of the Event Driven 
Executive system. 



Reference Summary 



The Reference Summary is a pocket -sized booklet to be used for 
quick reference. It lists the Event Driven language 
instructions with their syntax* the utility and program prepa- 
ration commands* and the completion codes. 



Tabs 



The tabs package must be ordered separately. The package con- 
tains 33 index tabs by subject* with additional blank tabs'. 
These extended tabular pages can be inserted at the front of 
various sections of the library. The tabs are color coded 
according to the major library topics. 



\y 



Reading Sequence 



All readers of the Event Driven Executive library should begin 
with the first three chapters of the System Guide 
("Introduction*" "The Supervisor and Emulator*" and "Data Man- 
agement") for an overview of the Event Driven Executive con- 
cepts and facilities. 

Readers responsible for installing and preparing the system 
should then continue in the System Gui de with "System Config- 
uration" and "System Generation." 

All readers should review the Utilities "Introduction" to 
become familiar with the utility functions available for the 
Event Driven Executive system. Then you can read more specific 
sections for particular utilities* operator commands* and pro- 
gram preparation facilities. 

After you have a basic understanding of the Event Driven Execu- 
tive system and how you can best use the system for your appli- 
cations* you should read the Languaqe Reference 

"Introduction." This will familiarize you with the potential 



J 
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of the Event Driven Language and prepare you to start coding 
application programs. 

If you have communications support for your Event Driven Execu- 
tive system* you should read the Communications Guide t which is 
an extension of the System Guide » Utilities , and the Lanpuaqe 
Reference . 

After you know the functions of the various Event Driven 
Language i nst r uct i ons » utilities* and program preparation 
facilities* you may wish to refer only to the Reference Summary 
for correct syntax while coding your applications. 

Only readers responsible for the support or modification of the 
Event Driven Executive system need to read Internal Des i an . 



OTHER EVENT DRIVEN EXECUTIVE PROGRAMMING PUBLICATIONS 



IBM Series/1 Event Driven Executive FORTRAN IV User's 
Guide , SC34-0315. 

IBM Series/1 Event Driven Executive PL/I Language 
Reference , 6034-0147. 

IBM Series/1 Event Driven Executive PL/I User's Guide * 
GC34-0148. 

IBM Series/l Event Driven Executive COBOL Programmer's 
Guide * SL23-0014. 

IBM Series/1 Event Driven Executive Sort/Merge Program-^ 
mer 's Gui de , SL23-0016 

IBM Series/1 Event Driven Executive Macro Assembler 
Reference ,GC34-Q317. 

IBM Series/1 Event Driven Executive Study Guide , 
SR30-0436. 



OTHER SERIES/1 PROGRAMMING PUBLICATIONS 

• IBM Series/1 Programming System Summary * GC34-0285. 

• IBM Series/1 COBOL Language Reference , 6034-0234. 

• IBM Series/1 FORTRAN IV Language Reference , GC34-0133 
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IBMSeries/1 Host Communications Facility Program 
Description Manual , SH20-1819. 

IBM Series/1 Mathematical and Functional Subroutine 
Li brarv User ' s Guide > SC3'^-0139. 

IBM Series/1 Macro Assembler Reference Summary ^ SX3^-0128 

IBM Series/1 Data Collection Interactive Programming RPQ 
P82600 User^s Guide, SC3<^-1654. 



OTHER PROGRAMMING PUBLICATIONS 

• IBM Data Processing Glossary , GC 20-1699, 

• IBM Series/1 Graphic Bibliography , GA34-0055. 

• IBM OS/VS Basic Telecommunications Access Method (BTAM) , 
GC27-6980. 

• General Information — Binary Synchronous Communications , 
GA27-3004. 

• IBM System/370 Program Prep aration Facility , SB30-1072. 
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IBM Series/1 ^952 Processor and Processor Features 
Description , GA34-008^. 

IBM Series /I ^953 Processor and Processor Features 
Description , GA34-0022. 

IBM Series/1 <^955 Processor and Processor Features 
Descr i pt ion , GA3^-0021. 

IBM Series/1 Communications Features Description , GA3^ 
-0028. 

IBM Series/1 3101 Display Terminal Description , GA3<^-203^. 

IBM Series/1 «^962 Disk Storage Unit and 496^ Diskette Unit 
Descr i pt i on , GA34-002<^. 

IBM Series/1 ^963 Disk Subsystem Description , GA3^-0051. 

IBM Series/1 ^966 Diskette Magazine Unit Description , 
GA3<^-0052. 
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IBM Seri'es/1 "^969 Magnetic Tape Subsystem Description > 
GA3«J*-0087. 

IBM Series/l ^973 Line Printer Description , GA3'^-00^4. 

IBM Se ri es/l ^ 97^ Printer Descriptio n , GA34-0025. 

I BM Series/1 <^9 78-l Display St ation (RPQ D02055) and 
Attac hment (RPQ D0203 8) General Information * GA34-1550 

IBM Series/l 4978-1 Display Station, Keyboard (RPQ D02056) 
General Information , GAS'^-lSSl 

I BM Seri e s/l <^978-l Display S t ation, Keyboard (RPQ D02057) 
General Information , GA3'^-1552 

IBM Se ries/l '^978-1 Display Station Keyboards (RPQ D0206<^ 
and D02065) General Information , GA3<^-1553 

IBM Series/l ^^979 Display Station Description , GA3A-0026 

IBM Series/l '^982 Sensor Input/Output Unit Description , 
GA34-0027 

IB M Series/l Data Colle ction Interactive RPQs D02312, 
D02313, and D02314 Custom Feature , GA34-1567 
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GLOSSARY 



This glossary contains terms that are used in the Series/1 Event Driven 
Executive software publications. All software and hardware terms are 
Series/1 oriented. This glossary defines terms used in this library and 
serves as a supplement to the IBM Data Processing Glossary (GC20-1699). 



c 



$SYSLOGA. The name of the 
alternate system logging device. 
This device is optional but» if 
defined/ should be a terminal with 
keyboard capability^ not just a 
pri nter . 

$SYSLOG. The name of the system 
logging device or operator 
station; must be defined for every 
system. It should be a terminal 
with keyboard capability^ not just 
a printer. 



$SYSPRTR. 

pri nter. 



The name of the system 



ACCA. See asynchronous 
communications control adapter ^ 

address key. Identifies a set of 
Series/1 segmentation registers 
and represents an address space. 
It is one less than the partition 
number. 



the Multiple Terminal Manager 
faci li ti es. 

asynchronous communications con- 
trol adapter. An ASCII terminal 
attached via ftl610, #2091 with 
#2092, or #2095 with #2096 adapt- 
ers. 

attention list. A series of pairs 
of 1 to 8 byte EBCDIC strings and 
addresses pointing to EDL 
instructions. When the attention 
key is pressed on the terminal, 
the operator can enter one of the 
strings to cause the associated 
EDL instructions to be executed. 

backup. A copy of data to be used 
in the event the original data is 
lost or damaged. 

base records. Records that have 
been placed into an indexed data 
set while in load mode. 



address space. The logical 
storage identified by an address 
key. An address space is the 
storage for a partition. 



basic exchange format. A standard 

format for exchanging data on 
diskettes between systems or 
devi ces. 



application program manager. The 
component of the Multiple Terminal 
Manager that provides the program 
management facilities required to 
process user requests. It con^ 
trols the contents of a program 
area and the execution of programs 
within the area. 



binary synchronous device data 
block (BSCDDB). A control block 
that provides the information to 
control one Series/1 Binary Syn- 
chronous Adapter. It determines 
the line characteristics and pro- 
vides dedicated storage for that 
line. 



application program stub. A 
collection of subroutines that are 
appended to a progrejm by the link- 
age editor to provide the link 
from the application program to 



block. (1) See data block or 
index block. (2) In the Indexed 
Method, the unit of space used by 
the access method to contain 
indexes and data. 
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BSCDDB. See binary synchronous 
device data block. 

buffer. An area of storage that 
is temporarily reserved for use in 
performing an input/output oper- 
ation/ into which data is read or 
from which data is written. See 
input buffer and output buffer. 

bypass label isrocessing. Access 
of a tape without any label proc- 
essing support. 

CCB. See terminal control block. 

character ima^e. An alphabetic* 
numeric* or special character 
defined for Bn IBM 4978 Display 
Station. Each character image is 
defined by a dot matrix that is 
coded into eight bytes. 

Character imaaa table. An area 
containing the 256 character 
images that can be defined for an 
IBM 4978 Display Station. Each 
character image is coded into 
eight bytes* the entire table of 
codes requiring 2048 bytes of 
storage. 

cluster. In an indexed file, a 
group of data blocks that is 
pointed to from the same 
primary-level index block* and 
includes the primary-level index 
block. The data records and 
blocks contained in a cluster ar& 
logically contiguous, but sre not 
necessarily physically contiguous. 

COD (change of direction). A 
character used with ACCA terminal 
to indicate a reverse in the 
direction of data movement. 

COmwand. A character string from 
a source external to the system 
that represents a request for 
action by the system. 

cowmon area. A usei — defined data 
area that is mapped into every 
partition at the same address. It 



can be used to contain control 
blocks or data that will be 
accessed by more than one program. 

completion code. An indicator 
that reflects the status of the 
execution of a program. The com- 
pletion code is displayed or 
printed on the program's output 
devi ce. 

conversion. See update. 

cross partition service. A 
function that accesses data in two 
parti ti ons. 

data block. In an indexed file* 
an area that contains control 
information and data records. 
These blocks are a multiple of 256 
bytes. 

data set. A group of contiguous 
records within a volume pointed to 
by a directory member entry in the 
directory for the volume. 

data set control block (DSCB). A 

control block that provides the 
information required to access a 
data set* volume or directory 
using READ and WRITE. 

data set shut doun. An indexed 
data set that has been marked (in 
main storage only) as unusable due 
to an error. 

DCE. See directory control entry. 

DDB. See disk data block. 

direct access. (l) The access 
method used to READ or WRITE 
records on a disk or diskette 
device by specifying their 
location relative the beginning of 
the data set or volume. (2) In 
the Indexed Access Method, locat- 
ing any record via its key without 
respect to the previous operation. 
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directory. A series of contiguous 
records in a volume that describe 
the contents in terms of allocated 
data sets and free spaces. 

directory control entry 
(DCE). The first 32 bytes of the 
first record of a directory in 
which a description of the direc- 
tory is stored. 

directory member entry tDME). A 

32-byte directory entry describing 
an allocated data set. 

disk data block (DDB). A control 
block that describes a direct 
access volume. 

display station. An IBM 4978 or 
4979 display terminal or similar 
terminal with a keyboard and a 
vi deo di splay. 

DUE. See directory member entry. 

DSCB. See data set control block. 

dynamic Storasa. An increment of 
storage that is appended to a pro- 
gram when it is loaded. 



event control block (ECB). A 

control block used to record the 
status (occurred or not occurred) 
of an event; often used to syn- 
chronize the execution of tasks. 
ECBs ar& used in conjunction with 
the WAIT and POST instructions. 

event driven language (EDL). The 
language for input to the Event 
Driven Executive compiler 
($EDXASM), or the Macro and Host 
assemblers in conjunction with the 
Event Driven Executive macro 
libraries. The output is inter- 
preted by the Event Driven Execu- 
tive emulator. 

EXIO (execute input or 
output). An EDL facility that 
provides user controlled access to 
Series/1 input/output devices. 

external label. A label attached 
to the outside of a tape that 
identifies the tape visually. It 
usually contains items of iden- 
tification such as file name and 
number » creation data^ number of 
volumes* department number, and so 
on. 



end-of-data indicator. A code 
that signals that the last record 
of a data set has been read or 
written. End-of-data is detei — 
mined by an end-of-data pointer in 
the DME or by the physical end of 
the data set. 



external name (EXTRN). The l- to 
8-character symbolic EBCDIC name 
for an entry point or data field 
that is not defined within the 
module that references the name. 

FCA. See file control area. 



ECB. See event control block 



FOB. See file control block. 



EDL. See Event Driven Language. 

emulator. The portion of the 
Event Driven Executive supervisor 
that interprets EDL instructions 
and performs the function speci- 
fied by each EDL statement. 

end-Of-tape (EOT). A reflective 
marker placed near the end of a 
tape and sensed during output. 
The marker signals that the tape 
is nearly full. 



file control area (FCA). A 

Multiple Terminal Manager data 
area that describes a file access 
request. 

file control block (FCB). In an 
indexed data set, the first block 
of the data set. It contains 
descriptive information about the 
data contained in the data set. 
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file manager. A collection of 
subroutines contained within the 
program manager of the Multiple 
Terminal Manager that provides 
common support for all disk data 
transfer operations as needed for 
transaction-oriented application 
programs. It supports indexed and 
direct files under the control of 
a single callable function. 

forma tted screen image. A 

collection of display elements or 
display groups (such as operator 
prompts and field input names and 
areas) that are presented together 
at one time on a display device. 

free pool. In an indexed data 
set» a group of blocks that can be 
used as either a data block or an 
index block. These differ from 
other free blocks in that these 
are not initially assigned to spe- 
cific logical positions in the 
data set. 

free space. In the Indexed Access 
Methods record spaces or blocks 
that do not currently contain 
data^ and are available for use. 

free space entry (FSE). A 4-byte 

directory entry defining an area 
of free space within a volume. 

FSE. See free space entry. 

hardware timer. The timer 
features available with the 
Series/1 processbrs. Specif- 
ically* the 7840 Timer Feature 
card or the native timer (4952 
only). Only one or the other is 
supported by the Event Driven 
Executive. 

host assembler. The assembler 
licensed program that executes in 
a 370 (host) system and produces 
object output for the Series/1. 
The source input to the host 
assembler is coded in Event Driven 
Language or Series/1 assembler 
language. The host assembler 



refers to the System/370 Program 
Preparation Facility (5798-NNQ). 

host system. Any system whose 
resources are used to perform 
services such as program prepara- 
tion for a Series/1. It can be 
connected to a Series/1 by a com- 
munications link. 

lACB. See indexed access control 
block. 

lAR. See instruction address 
regi ster. 

ICB. See indexed access control 
block. 

IIB. See interrupt information 
byte. 

image store. The area in a 4978 
that contains the character image 
table. 

index. In the Indexed Access 
Method» an ordered collection of 
pairsr each consisting of a key 
and a pointer* used to sequence 
and locate the records in an 
Indexed Access Method data set. 

index block. In an indexed file* 
an area that contains control 
information and index entries. 
These blocks are a multiple of 256 
bytes. 

indexed access control block 
tIACB/ICB). The control block 
that relates an application pro- 
gram to an indexed data set. 

indexed access method. An access 
method for direct or sequential 
processing of fixed-length records 
by use of a record's key. 

indexed data set. A data set 
specifically created* formatted 
and used by the Indexed Access 
Method. An indexed data set may 
also be called an indexed file. 
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indexed file. Synonym for indexed 
data set. 

index entry. In an indexed file» 
a key-pointer pair> where the 
pointer is be used to locate a 
loMei — level index block or a data 
block. 



request to or from a terminal. 

job. A collection of related 
program execution requests pre- 
sented in the form of job control 
statements^ identified to the 
jobstream processor by a JOB 
statement. 



index register (4(1» »2). Tmo 

Mords defined in EDL and contained 
in the task control block for each 
task. They are used to contain 
data or for address computation. 

input buffer. (1) See buffer. 
(2) In the Multiple Terminal Man- 
ager » an area for terminal input 
and output. 

input output control block 
(I0C6). A control block contain- 
ing information about a terminal 
such as the symbolic name, size 
and shape of screen^ the size of 
the forms in a printer. 

instruction address register 
(lAR). The pointer that identi- 
fies the instruction currently 
being executed. The Series/1 
maintains a hardware lAR to deter- 
mine the Series/1 assembler 
instruction being executed. It is 
located in the level status block 
(LSB). 

interactive. The mode in which a 
program conducts a continuous 
dialogue between the user and the 
system. 

internal label. An area on tape 
used to record identifying infor- 
mation (similar to the identifying 
information placed on an external 
label). Internal labels are 
checked by the system to ensure 
that the correct volume is 
mounted. 

interrupt information byte 
(IIB). In the Multiple Terminal 
Manager » a word containing the 
status of a previous input/output 



job control statement. A 
statement in a job that specifies 
requests for program execution* 
program parameters* data set defi- 
nitions* sequence of execution* 
and* in general* describes the 
environment required to execute 
the program. 

job stream processor. The job 
processing facility that reads job 
control statements and processes 
the requests made by these state- 
ments. The Event Driven Executive 
job stream processor is $JOBUTIL. 

key. In the Indexed Access 
Method* one or more consecutive 
characters in a data record* used 
to identify the record and estab- 
lish its order with respect to 
other records. See also key 
field. 

key field. A field* located in 
the same position in each record 
of an Indexed Access Method data 
set* whose content is used for the 
key of a record. 

level status block (LSB). A 
Series/1 hardware data area that 
contains processor status. 

library. A set of contiguous 
records within a volume. It con- 
tains a directory* data sets 
and/or available space. 

line. A string of characters 
accepted by the system as a single 
input from a terminal; for exam- 
ple* all characters entered before 
the carriage return on the tele- 
typewriter or the ENTER key on the 
display station is pressed. 
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link edit. The process of 
resolving symbols in one or more 
object modules to produce another 
single module that is the input to 
the update process. 

load node. In the Indexed Access 
Method* the mode in which records 
are initially placed in an indexed 
file. 

load module. A single module 
having cross references resolved 
and prepared for loading into 
storage for execution. The module 
is the output of the $UPDATE or 
$UPDATEH utility. 

load point, A reflective marker 
placed near the beginning of a 
tape to indicate where the first 
record is written. 

lock. In the Indexed Access 
Method* a method of indicating 
that a record or block is in use 
and is not available for another 
request . 

LSB. See level status block. 

mambeP". A term used to identify a 
named portion of a partitioned 
data set (PDS). Sometimes member 
is also used as a synonym for a 
data set. See data set. 

menu. A formatted screen image 
containing a list of options. The 
user selects an option to invoke a 
program. 

menu-driven. The mode of 
processing in which input consists 
of the responses to prompting from 
an option menu. 

multifile volume. A unit of 
recording media* such as tape reel 
or disk pack* that contains more 
than one data file. 

multiple terminal manager. An 
Event Driven Executive licensed 
program that provides support for 



transact i on-ori en ted applicati ons 
on a Series/1. It provides the 
capability to define transactions 
and manage the programs that sup- 
port those transactions. It also 
manages multiple terminals as 
needed to support these trans- 
act i ons. 

multi volume file. A data file 
that* due to its size* requires 
more than one unit of recording 
media (such as tape reel or disk 
pack) to contain the entire file, 

non-labeled tapes. Tapes that do 
not contain identifying labels (as 
in standard labeled tapes) and 
contain only files separated by 
tapemarks. 

null character. A user-defined 
character used to define the 
unprotected fields of a formatted 
screen . 

option selection menu. A full 
screen display used by the Session 
Manager to point to other menus or 
system functions* one of which is 
to be selected by the operator. 
(See primary option menu and sec- 
ondary option menu.) 

output buffer. (1) See buffer. 
(2) In the Multiple Terminal Man- 
ager* an area used for screen 
output and to pass data to subse- 
quent transaction programs. 

overlay. The technique of reusing 
a single storage area allocated to 
a program during execution. The 
storage area can be reused by 
loading it with overlay programs 
that have been specified in the 
PROGRAM statement of the program. 

overlay area. A storage area 
within a program reserved for 
overlay programs specified in the 
PROGRAM statement. 
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parameter selection menu. A full 
screen display used by the Session 
Manager to indicate the parameters 
to be passed to a program. 

partition. A contiguous 
fixed-sized area of storage. Each 
partition is a separate address 
space. 



physical timer, 
hardware timer. 



Synonym for 



prefind. To locate the data sets 
or overlay programs to be used by 
a program and to store the neces- 
sary information so that the time 
required to load the profound 
items is reduced. 

primary-level index block. In an 

indexed data set, the lowest level 
index block. It contains the rel- 
ative block numbers (RBNs) and 
high keys of several data blocks. 
See cluster. 

primary menu. The program 
selection screen displayed by the 
Multiple Terminal Manager. 

primary option menu. The first 
full screen display provided by 
the Session Manager. 

primary task. The first task 
executed by the supervisor when a 
program is loaded into storage. 
It is identified by the PROGRAM 
statement. 

priority, A combination of 
hardware interrupt level priority 
and a software ranking within a 
level. Both primary and secondary 
tasks will execute asynchronously 
within the system according to the 
priority assigned to them. 

process mode. In the Indexed 
Access Method, the mode in which 
records may be retrieved, updated, 
inserted or deleted. 



processor status word (PSM). A 
16-bit register used to (1) record 
error or exception conditions that 
may prevent further processing and 
(2) hold certain flags that aid in 
error recovery. 

program. A disk- or 
diskette-resident collection of 
one or more tasks defined by a 
PROGRAM statement; the unit that 
is loaded into storage. (See pri- 
mary task and secondary task.) 

program header. The control block 
found at the beginning of a 
program that identifies the prima- 
ry task, data sets, storage 
requirements and other resources 
required by a program. 

program/Storage manager. A 
component of the Multiple Terminal 
Manager that controls the 
execution and flow of application 
programs within a single program 
area and contains the support 
needed to allow multiple opei — 
ations and sharing of the program 
area. 

protected field. On a display 
device, a field in which the opei — 
ator cannot enter, modify, or 
erase data from the keyboard. It 
can contain text that the user can 
read. 

PSM. See processor status word. 

QCB . See queue control block. 

QD. See queue descriptor. 

QE. See queue element. 

queue control block (QCB). A data 
area used to serialize access to 
resources that cannot be shared. 
See serially reusable resource. 

queue descriptor (QD). A control 
block describing a queue bui It by 
the DEFINEQ instruction. 
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queue element (QE). An entry in 
the queue defined by the queue 
descriptor. 

record. (1) The smallest unit of 
direct access storage that can be 
accessed by an application program 
on a disk or diskette using READ 
and WRITE. Records are 256 bytes 
in length. (2) In the Indexed 
Access Methods the logical unit 
that is transferred between $IAM 
and the user's buffer. The length 
of the buffer is defined by the 
user. 

recovery. The use of backup data 
to recreate data that has been 
lost or damaged. 

reflective marker. A small 
adhesive marker attached to the 
reverse (nonrecordi ng) surface of 
a reel of magnetic tape. 
Normally, two reflective markers 
are used on each reel of tape. 
One indicates the beginning of the 
recording area on the tape (load 
point), and the other indicates 
the proximity to the end of the 
recording area (EOT) on the reel. 

relative record number. An 

integer value identifying the 
position of a record in a data set 
relative to the beginning of the 
data set. The first record of a 
data set is record one, the second 
is record two, the third is record 
three. 



roll screen. A display screen on 
which data is displayed 24 lines 
at a time or data is entered line 
by line, beginning with line at 
the top of the screen and continu- 
ing through line 23 at the bottom 
of the screen. Whan a roll screen 
device's screen is full (all 24 
lines used), an attempt to display 
the next line results in removal 
of the old screen (screen is 
erased) and the new line on line 
is displayed at the top of the 
screen. 

SBZOCB. See sensor based I/O 
control block. 

second-level index block. In an 
indexed data set, the 
second-lowest level index block. 
It contains the addresses and high 
keys of several primary-level 
index blocks. 

secondary option menu. In the 
Session Manager, the second in a 
series of predefined procedures 
grouped together in a hierarchical 
structure of menus. Secondary 
option menus provide a breakdown 
of the functions available under 
the session manager as specified 
on the primary option menu. 

secondary task. Any task other 
than the primary task. A second- 
ary task must be attached by a 
primary task or another secondary 
task. 
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reorganize. For an indexed data 
set, the copying of the data to a 
new indexed data set in a manner 
that rearranges the data for more 
optimum processing and free space 
di stributi on. 

return code. An indicator that 
reflects the results of the exe- 
cution of an instruction or sub- 
routine. The return code is 
placed in the task code word (at 
the beginning of the task control 
block) . 



sector. The smallest addressable 
unit of storage on a disk or 
diskette. A sector on a 4962 or 
4963 disk is equivalent to an 
Event Driven Executive record. On 
a 4964 or 4966 diskette, two sec- 
tors are equivalent to an Event 
Driven Executive record. 

sensor based I/O control block 
(SBIOCB). A control block con- 
taining information related to 
sensor I/O operations. 
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secfuential access. The processing 
of a data set in order of occui — 
rence of the records in the data 
set. (1) In the Indexed Access 
Method* the processing of records 
in ascending collating sequence 
order of the keys. (2) When using 
READ/WRITE, the processing of 
records in ascending relative 
record number sequence. 

serially reusable resource 
(SRR). A resource that can only 
be accessed by one task at a time. 
Serially reusable resources are 
usually managed via (1) a QCB and 
ENQ/DEQ statements or (2) an ECB 
and WAIT/POST statements. 

session manager. A series of 
predefined procedures grouped 
together as a hierarchical struc- 
ture of menus from which you 
select the utility functions* pro- 
gram preparation facilities* and 
language processors needed to pre- 
pare and execute application pro- 
grams. The menus consist of a 
primary option menu that displays 
functional groupings and secondary 
option menus that display a break- 
down of these functional 
groupi ngs. 

shared resource. A resource that 
can be used by more than one task 
at the same time. 



shut down, 
down . 



See data set shut 



trailer label following tFie data 
records) . 

static screen. A display screen 
formatted with predetermined 
protected and unprotected areas. 
Areas defined as operator prompts 
or input field names are protected 
to prevent accidental overlay by 
input data. Areas defined as 
input areas are not protected and 
ar& usually filled in by an opera- 
tor. The entire screen is treated 
as a page of information. 

subroutine. A sequence of 
instructions that may be accessed 
from one or more points in a pro- 
gram. 

supervisor. The component of the 
Event Driven Executive capable of 
controlling execution of both sys- 
tem and application programs. 

system configuration. The process 
of defining devices and features 
attached to the Series/1. 

SYSGEN. See system generation. 

system generation. The processing 
of user selected options to create 
a supervisor tailored to the needs 
of a specific Series/1 configura- 
ti on. 

system partition. The partition 
that contains the supervisor (par- 
tition number 1* address space 0). 



source module/program. A 
collection of instructions and 
statements that constitute the 
input to a compiler or assembler. 
Statements may be created or modi- 
fied using one of the text editing 
faci li ti es. 

standard labels. Fixed length 
80-character records on tape con- 
taining specific fields of infoi — 
mation (a volume label identifying 
the tape volume* a header label 
preceding the data records* and a 



tapemark. A control character 
recorded on tape used to separate 
f i les. 

task. The basic executable unit 
of work for the supervisor. Each 
task is assigned its own priority 
and processor time is allocated 
according to this priority. Tasks 
run independently of each other 
and compete for the system 
resources. The first task of a 
program is the primary task. All 
tasks attached by the primary task 
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are secondary tasks. 

task code word. The first two 
words (32 bits) of a task's TCB; 
used by the emulator to pass 
information from system to task 
regarding the outcome of various 
operations* such as event com- 
pletion or arithmetic operations. 

task control block (TCB). A 
control block that contains infor- 
mation for a task. The informa- 
tion consists of pointers, save 
areas* work areas* and indicators 
required by the supervisor for 
controlling execution of a task. 

task supervisor. The portion of 
the Event Driven Executive that 
manages the dispatching and 
switching of tasks. 

TCB. See task control block. 

terminal. A display station, 
teletypewriter or printer. 

terminal control block (CCB). A 
control block that defines the 
device characteristics* provides 
temporary storage* and contains 
links to other system control 
blocks for a particular terminal. 

terminal environment block 
(TEB). A control block that con- 
tains information on a terminal's 
attributes and the program manager 
operating under the Multiple Ter- 
minal Manager. It is used for 
processing requests between the 
terminal servers and the program 
manager. 

terminal screen manager. The 
component of the Multiple Terminal 
Manager that controls the presen- 
tation of screens and communi- 
cations between terminals and 
transaction programs. 

terminal server. A group of 
programs that perform all the 
input/output and interrupt handl- 



ing functions for terminal devices 
under control of the Multiple Tei — 
minal Manager. 

trace ransa. A specified number 
of instruction addresses within 
which the flow of execution can be 
traced. 

transaction oriented 
applications. Program execution 
driven by operator actions* such 
as responses to prompts from the 
system. Specifically* applica- 
tions executed under control of 
the Multiple Terminal Manager. 

transaction program. See 
transact i on-ori en ted appl i cati ons. 

transaction selection menu. A 
Multiple Terminal Manager display 
screen (menu) offering the user a 
choice of functions* such as read- 
ing from a data file* displaying 
data on a terminal* or waiting for 
a response. Based upon the choice 
of option* the application program 
performs the requested processing 
operati on. 

unprotected field. On a display 
device* a field in which the user 
can enter* modify* or erase data 
using the keyboard. Unprotected 
fields on a static screen are 
defined by the null character. 

update. (1) To alter the contents 
of storage or a data set. (2) To 
convert object modules* produced 
as the output of an assembly or 
compilation* or the output of the 
linkage editor, into a form that 
can be loaded into storage for 
program execution and to update 
the di rectory of the volume on 
which the loadable program is 
stored. 

user exit. CD Assembly language 
instructions included as part of 
an EDL program and invoked via the 
USER instruction. (2) A point in 
an IBM-supplied program where a 
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user written routine can be given 
control . 

vary offline. (1) To change the 
status of a device from online to 
offline. Nhen a device is off- 
line» no data set can be accessed 
on that device. (2) To place a 
disk or diskette in a state where 
it is not available for use by the 
system; however, it will still be 
available for executing I/O at the 
basic access level (EXIO). 



volume. A disk or diskette 
subdivision defined during system 
configuration. A volume may con- 
tain up to 32,767 records. As 
many volumes may be defined for a 
disk as will physically fit. A 
diskette is limited to one volume. 

volume label. A label that 
uniquely identifies a single unit 
of storage media. 



vary online. To restore a device 
to a state where it is available 
for use by the system. 
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COMMON INDEX 



This index is common to the Event Driven Executive library. The index 
includes entries from the seven publications listed below. (The Glossary 
is not indexed.) Each publication has a copy of the index^ which provides 
a cross-reference between the publications. 

Each page number entry contains a single letter prefix which identifies 
the publication where the listed subject can be found. The letter pre- 
fixes have the following meanings* 

C = Communications and Terminal Application Guide 

I = Internal Design 

L = Language Reference 

S = System Gui de 

U = Utilities^ Operator Commands, Program Preparation, Messages and 
Codes 

M = Multiple Terminal Manager Internal Design 

A = Indexed Access Method Internal Design 



Spacial Characters 



$$EDXLIB system name L-228, S-57 
$$EDXVOL system name L-228, S-57 
$A display active programs, 

operator command S-63, U-11 
$ATTASK special task control 

block L-61 
$AUTO link edit auto call data 

set S-^03, U-401 
$B blank (clear) screen, operator 

command S-63, U-12 
$BSCTRCE trace utility for ESC 

lines C-61 
$BSCUT1 trace printing utility for 

BSC C-62 
$BSCUT2 test utility for BSC 

lines C-6^ 
$C cancel a program, operator 

command S-63, U-13 
$COMPRES library compress S-64, 

U-57 
$COPY copy data sets S-6^, U-59 
$C0PYUT1 copy data sets with 

allocation S-64, U-64 
$CP change terminal's partition 

assignment command 

overview 1-73, S-63 
syntax U-14 
$D dump storage, operator command 

S-63, U-15 
$DASDI format disk or diskette 

S-64, U-68 
$DBUGNUC debug module description 

1-77 
$DEBUG debugging tool U-82 
$DICOMP display composer 

command description U-106 
create partitioned data set 

member S-247 
invoking U-105 
overview S-67 
$DIINTR display interpreter U-150 



$DISKUT1 allocate/delete, list 
directory data 

$JOBUTIL procedure S-229 
allocate partitioned data set 

S-248 
command descriptions U-135 
overview S-64 
$DISKUT2 patch, dump, or clear 
member 

description U-142 
overview S-64 

printing I/O error logs S-275 
syntax U-143 
$DISKUT3 data management utility 
description S-315 
input to S-316 
request block contents S-317 
return codes S-319, U-444 
$DIUTIL display data base utility 

S-248, U-150 
$DUnP dump saved storage and 

registers utility U-163 
$E eject printer page, operator 

command S-63, U-16 
$EDIT1/$EDIT1N text editors 
command syntax 
EDIT U-174 
EDIT mode subcommands 

U-182 
END U-175 
LIST U-176 
READ U-177 
SUBMIT U-179 
WRITE U-180 
control keys U-172 
data set requirements U-169 
line editing commands U-203 
overview S-66, U-169 
summary of commands and 
subcommands U-171 
$EDXASM Event Driven Language 
compi ler 

features supported U-361 
internal overview 1-5, 1-211 
i nvoki ng 

with $JOBUTIL U-368 
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with $L U-370 
with session manager 
U-369 
listing program ($EDXLIST) 

U-370 
options U-358 
output U-359 

overlay program example 1-244 
overview S-71, U-356 
programming considerations 
U-361 

arithmetic expression 

operators U-365 
ATTNLIST U-365 
COPY statements U-362 
ECB and QCB U-362 
EQU U-365 

GETEDIT and PUTEDIT U-365 
instructions requiring 

support modules U-365 
lODEF statement placement 

U-364 
multiple declarations on 

DATA/DC U-363 
source line continuation 
U-361 
required data sets U-357 
usage example S-397 
using the compiler U-356 
$EDXATSR supervisor interface 

routine 1-48 
$EDXDEF hardware configuration 

editing to match hardware con- 
figuration S-117 
overview I-5» 1-6 
storage map 1-7 
$EDXL language control data set of 

$EDXASM 1-221, U-357 
$EDXLIST compiler listing program 

U-370 
$EDXNUC supervisor data set 

in system generation S-126 
overview 1-5 
with $LINK utility U-399 
$EDXNUC supervisor data sets 

U-399 
$EXEC language emulator linkage 

1-279, 1-313 
$EXEC session manager option 

S-216, U-41 
$FONT 4978 character image tables 

utility S-68, U-205 
$FSEDIT full-screen editor, host 
and native 

data set requirements U-209 
opti ons 

BROWSE U-213 
EDIT U-214 
END U-218 
READ U-216 
SUBMIT U-217 
WRITE U-216 
overview S-66, U-209 
primary commands U-218 
program function (PF) keys 

U-211 
scrolling U-210 
summary of options and 
commands U-212 
$HCFUT1 Host Communications 

Facility utility C-107 
$IAn Indexed Access Method load 

module S-155 
$IAM task error exit S-178 



$IAMUT1 Indexed Access Method 

utility S-148, U-235 
$IDEF $EDXASM instruction 
def i ni ti on 

description 1-241 
instruction format 1-226 
$IMAGE define screen image 
utility S-68, U-250 
usage example S-387 
$IMDATA subroutine S-303 

usage example S-375 
$IMDEFN subroutine S-301 

usage example S-375 
$IMOPEN subroutine S-300 

usage example S-374 
$IMPROT subroutine S-302 

usage example S-375 
$INDEX subroutine, $EDXASM 1-233 
$INITDSK initialize or verify 

volume S-64, U-256 
$INITIAL automatic initialization 
and restart 

description S-129 
with session manager S-209, 
U-28 
$IOTEST test sensor I/O, list con- 
figuration S-67, U-263 
$JOBUTIL job stream processor 
S-69, U-271 

commands U-272 
set up procedure U-271 
usage example S-408, U-290 
$L load program, operator command 
internals 1-23 
overview S-63 
syntax U-17 
$LEMSG $LINK message data set 

U-401 
$LINK linkage editor 

data set requirements U-400 
description U-390 
in system generation 1-5 
i nvoki ng 

with $JOBUTIL U-405 
with $L U-405 
with session manager 
U-406 
overview S-71 
usage example S-402 
$LNKCNTL data set S-118 
$LOADER 1-19, 1-22 

module description 1-78 
$LOG I/O error logging utility 
description S-270, U-292 
overview S-67 
$LPARSE subroutine 1-240 
$MOVEVOL disk volume dump/restore 

S-65, U-294 
$P patch storage, operator 

command S-63, U-18 
$PACK/$UNPAC!C subroutines S-309 
$PDS partitioned data set utility 
in a program S-259 
overview S-65 
$PFMAP identify 4978 program 

function keys S-68, U-301 
$PREFIND prefind data sets and 

overlays S-69, U-302 
$PRT2780 spooled print utility 

C-72 
$PRT3780 spooled print utility 

C-72 
$RJE2780 remote job entry utility 
C-73, S-66 
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$RJE3780 remote job entry utility 

C-73, S-66 

$RMU (see Remote Management Util- 
ity) 
$SMCTL session manager program 

S-209, S-212 
$SMEND session manager program 

S-212 
$SMJOBR session manager program 

S-212 
$SMLOG session manager program 

S-212 
$SMMAIN session manager program 

S-210, S-212, U-28 
$SMriLOG, logon menu for session 

manager S-212 
$SrinPRIM* primary option menu for 

session manager S-212, U-27, 

U-35 
$SMri02, program preparation sec- 
ondary option menu S-214, U-37 
$SMM03, data management secondary 

option menu S-215, U-39 
$SMM04, terminal utilities 

secondary option menu S-215, 

U-41 
$SMM05, graphics utilities second- 
ary option menu S-216, U-<+l 
$SMM06, execute program utilities 

secondary option S-216 
$SMM07, job stream processor 

utilities secondary option S-216 
$Srin08, communications utilities 

option S-217, U-^3 
$SMM09, diagnostic utilities 

S-217, U-4^ 
$START supervisor entry point 

1-279, 1-313 
$STOREMAP example 1-27 
$SYSCOM data area 1-12, 1-279, 

1-313, S-113 
$SYSLOG system logging device 

overview S-110 
$SYSLOGA alternate system logging 

devi ce 

overview S-111 
$SYSPRTR system printer 

overview S-111 
$S1ASM Series/1 macro assembler 
description U-372 
internals 1-5, 1-253 
overview S-9 

storage map, general 1-256 
$T set date/time, operator 

command S-63, U-19 
$TAPEUT1 tape management utility 

U-311 
$TCBCCB (ATTACH) L-59 
$TERMUT1 change terminal 

parameters S-68, U-334 
$TERMUT2 

process ^978 image or control 

store S-68, U-339 
restore ^974 image U-339 
$TERMUT3 send message to a 

terminal S-68, U-344 
$TRAP class interrupt trap 

utility S-67, U-348 
$UNPACK/$PACK subroutines S-309 
$UPDATE object program converter 
description U-408 
in system generation 1-5 
overview S-69 
usage example S-407 



$UPDATEH object program converter 

(host) S-69, U-418 
$VARYOFF set disk, diskette, or 

tape offline S-63, U-20 
$VARYON set disk, diskette, or 

tape online S-63, U-22 

with standard labeled tape 
S-237 
$W display date/time, operator 

command S-63, U-25 
#1 index register 1 L-6 
S2 index register 2 L-6 



A after, $FSEDIT line command 

U-226 
A-conversion L-153 
A/I (see analog input) 
A/0 (see analog output) 
abort task level (SVC abend) 1-49 
ACCA terminal C-7, L-295 
Access Method, Indexed 

(see Indexed Access Method) 
ACTION, Multiple Terminal Manager 
CALL 

coding description C-130, 

L-360 
internals M-9 
overview C-117, L-29 
acti vate 

error logging, $LOG utility 

U-293 
realtime data member, RT 

$DICOMP subcommand U-124 
stopped task, GO $DEBUG 

command U-93 
task supervisor execution 

state 1-43 
TRAP function of storage dump, 
$TRAP utility U-348 
AD 

add member, $DICOMP command 

U-106 
advance, $DICOMP subcommand 

U-111 
advance X,Y (PDS) S-255 
assign define key, $TERMUT2 
command U-342 
add 

add member, AD $DICOMP com- 
mand U-106 
null data set on tape volume, 

TA $TAPEUT1 command U-330 
options to the session 

manager S-224 
support for new I/O terminals 
1-117 

calling conventions 1-118 
code translation tables 

1-118 
linkage conventions 1-119 
terminal instruction 
modification 1-119 
ADD data manipulation instruction 
coding description L-52 
overview L-19 
precision table L-53 
address relocation translator 

1-71, S-42 
addressing indexing feature L-6 
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ADDV data manipulation 
1 nstructi on 

coding description L-5^ 
index register use L-55 
overview L-19 
precision table L-55 
advance/ AD $DICOMP subcommand 

U-111 
advance and prompting input, ter- 
minal I/O L-46 



AI 
AL 



(see analog input) 



$DIUTIL 



data member, 

U-151 
data set, $DISKUT1 

U-137 
data set, $JOBUTIL 

U-273 
member, $DICOMP 

U-107 



U-107 
U-151 

1-166, 



allocate 

command 

allocate 

command 

allocate 

command 

allocate 

command 

allocate 

data set 

$JOBUTIL command U-273 
AL $DISKUT1 command U-137 
ALLOCATE function C-214 
tape, TA $TAPEUT1 command 
U-333 
member 

$DICOMP command 
$DIUTIL command 
$PDS S-261 
ALLOCATE function C-216, 

1-174 
allowable precision table L-20 
alter member AL $DICOriP command 

U-107 
alter terminal configuration, 

$TERMUT1 U-334 
alternate system logging device 

($SYSLOGA) S-47 
alternate tracks S-58, U-73, U-78 
ALTIAM Indexed Access Method 

subroutine S-167 
analog input S-49 

AI $IOTEST command U-268 
control block 1-129 
lODEF statement L-187 
overview S-49 
SBIO instruction L-263 
SENSORIO configuration 
statement L-39 
analog output 

AO $IOTEST command U-26<^ 
control block 1-129 
description S-<^9 
lODEF statement L-186 
SBIO instruction L-264 
SENSORIO configuration 
statement L-39, S-8<^ 
AND data manipulation instruction 
coding description L-57 
overview L-19 
AO (see analog output) 
application program 

automatic initialization and 

restart S-129 
indexed access S-149 
introduction L-1 
manager C-119 
preparation U-351 
size estimating S-344 
structure L-8 
support S-20 
ASCII terminals 
codes S-110 



configuring S-96 
devices supported C-6, S-14 
graphics L-26, S-46 
TERMINAL statement examples 
S-106 
ASMERROR, $EDXASM instruction 

1-230 
assembler 

(see $EDXASM) 
(see $S1ASM) 
(see host assembler) 
assi gn 

alternate for defective 4963 

sector, $DASDI utility U-78 
DEFINE key in 4978 control 
store, AD $TERMUT2 command 
U-341 
asynchronous communications con- 
trol adapter (see ACCA) 
AT set breakpoints and trace 

ranges, $DEBUG command U-90 
ATTACH task control instruction 
coding description L-59 
internals 1-44 
overview L-42, S-34 
attention handling, terminal I/O 

1-108, L-47, S-63 
attention keys, terminal I/O L-47 
attention list (see ATTNLIST) 
ATTN key (see attention handling) 
ATTNLIST task control statement 
$ATTASK L-61 
coding description L-61 
overview L-42, S-30 
attribute character, 3101 C-122 
autocall 

option, $LINK U-401 
AUTOCALL statement requirement 

(WXTRN) L-323 
automatic 

application initialization 

S-13, S-129 
application restart S-13, 
S-129 
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B before, $FSEDIT line command 

U-226 
backup disk or disk volume on 

tape, ST $TAPEUT1 command U-330 
backup dump restore utility, 

$MOVEVOL U-294 
base records, indexed data set 
definition S-149 
loading S-160 
basic exchange 

diskette data set copy utili- 
ty, $COPY U-59 
basic supervisor and emulator (see 

supervisor/emulator) 
batch job processing (see 

$JOBUTIL) 
BEEP, Multiple Terminal Manager 
CALL 

coding description C-137, 

L-361 
internals M-9 
overview C-117, L-29 
binary synchronous communications 
automatic retry S-17 
BSCAM/BSCAMU module 
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descriptions 1-80 
BSCLINE configuration state- 
ment C-42, S-76 
control flow (BSCAM) 1-1^7 
device data block (BSCDDB) 

1-133 
features C-35» S-16 
Host Communications Facility 

protocol 1-156 
instruction formats C-38> 

1-1^4 
multipoint operation C-36, 

S-16 
overview S-16 
point-to-point lines S-16 
Remote Management Utility 

requirements C-208 
sample programs C-59 
special labels for, 
description 1-149 
system internal design 1-133 
test utility, $BSCUT2 C-64 
trace printing routine, 

$BSCUT1 C-62 
trace routine, $BSCTRCE C-61 
blank screen, $B operator command 

S-63, U-12 
BLANK TERMCTRL function L-288 
BLDTXT subroutine, $EDXASM 1-237 
BLINK TERNCTRL function L-288 
BLP (see bypass label processing) 
BOT (begi nni ng-of-tape) L-40 
BOTTOM reposition line pointer, 

$EDIT1/N editor subcommand U-183 
boundary requirement, full-word 
DO L-34 
IF L-34 
PROGRAM L-225 
BP list breakpoints and trace 
ranges, $DEBUG command U-92 
breakpoints and trace setting, AT 

$DEBUG command U-90 
BROWSE display data set, $FSEDIT 

option U-213 
BSC (see binary synchronous 

communi cati ons) 
BSCAM (see binary synchronous com- 
muni cati ons) 
BSCCLOSE BSC statement 1-144, 
1-148 

coding description C-38 
BSCDDB binary synchronous device 
data block 

description of 1-133 
equates 1-291 
BSCEQU L-11 
BSCIA immediate action routine 

(BSC) 1-148 
BSCIOCB BSC statement C-39, 1-144 
BSCLINE configuration statement 

C-42, S-76 
BSCOPEN BSC statement C-44, 

1-145, 1-148 
BSCREAD BSC statement C-45, 

1-145, 1-148 
BSCWRITE BSC statement C-49, 

1-146, 1-148 
BSF (backward space file) L-75 
BSR (backward space record) L-75 
BTE, buffer table entry A-20 
BU build data member, $DIUTIL 

command U-153 
buffer 

table entry 

definition A-20 



description A-31 
terminal I/O buffer 
management 1-109 
BUFFER data definition statement 
coding description L-65 
overview L-17 
build data member, BU $DIUTIL 

command U-153 
building an indexed data set 

U-247 
burst output with electronic dis- 
play screens L-46 
bypass label processing U-311 
description S-244 



change a key definition, 
$TERMUT2 command U-342 
copy line, $FSEDIT line 
command U-226 
CA cancel 

assembly, $EDXASM attention 

request U-358 
copy, $C0PYUT1 attention 

request U-64 
list option, $FSEDIT attention 

request U-217 
listing, $EDXLIST attention 
request U-358 
CAD copy all data members, 

$C0PYUT1 command U-64 
CALL 

copy all members, $C0PYUT1 

command U-64 
program control instruction 
coding description L-68 
Indexed Access Method 

syntax S-146 
Multiple Terminal Manager 

syntax L-359 
overview L-32, S-31 
program L-68 
subroutine L-68 
callable routines L-30 
CALLFORT program control 
i nstructi on 

coding description L-70 
overview L-32 
cancel 

$C operator command U-13 
assembly, CA $EDXASM attention 

request U-358 
copy, CA $C0PYUT1 attention 

request U-64 
dump, CA $DUMP command U-165 
list option, CA $FSEDIT 

attention request U-217 
listing, CA $EDIT/N attention 
request U-172 
CAP copy all programs, $C0PYUT1 

command U-64 
CC copy block, $FSEDIT line 

command U-226 
CCB 

equate table 1-292 

internals 1-105, 1-119 

i nterprocessor communications 

C-30 
use in terminal I/O support 
1-113 
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CCBEQU L-11 
CD 

clear data set, $DISKUT2 com- 
mand U-144 
copy data set, $COPY command 

U-61 
copy data set, $TAPEUT1 
command U-313 
CDATA, Multiple Terminal Manager 
CALL 

coding description C-139, 

L-362 
internals M-9 
overview L-29 
CDRRM equates C-292 
CG copy all members (generic) 

$C0PYUT1 command U-64 
CH 

change hardcopy device, 

$BSCUT2 command C-70 
change host library, $UPDATEH 
command U-^20 
chain, ECB/QCB/TCB 1-55 
CHAIN supervisor service routine 

1-54 
CHAIND supervisor service routine 

1-54 
CHAINE supervisor service routine 

1-54 
chaining L-27 
CHAINP supervisor service routine 

1-54 
change 

address assignment of termi- 
nal, RA $TERMUT1 command 
U-336 
base address, QUALIFY $DEBUG 

command U-101 
character string, CHANGE 
$EDIT1/N editor subcommand 
!'-184 
c! =3cter string, change 
$J-;iEDIT primary command 
U-219 
execution sequence, GOTO ODE- 
BUG command U-94 
graphics or report display 
profile, $DICOMP utility 
U-105 
hardcopy device, CH $BSCUT2 

command C-7 
hardcopy device, RH $TERMUT1 

command U-338 
host library, CH $UPDATEH 

command U-420 
key definition in 4978 control 

store, C $TERMUT2 U-342 
name of logical device, RE 

$TERMUT1 command U-337 
output volume, CV $UPDATE 

command U-409 
page formatting parameters of 
a terminal, CT $TERMUT1 
U-335 
partition assignment, $CP 

operator command U-14 
realtime data member name RT 

($PDS) S-258 
tape label support U-322 
volume 

CV $BSCUT1 command C-62 
CV $C0PYUT1 command U-64 
CV $DISKUT1 command U-137 
CV $DISKUT2 command U-143 
CV $UPDATEH command U-418 



character constants L-89 
character image table U-205 
CHGPAN, Multiple Terminal Manager 
CALL 

coding description C-135, 

L-364 
internals M-9 
overview C-124, L-29 
CL clear work data set, $FSEDIT 

primary command U-221 
class interrupt vector table 

I-IO, 1-277 
class interrupts, intercepting, 

$TRAP utility U-348 
clear 

data set, CD $DISKUT2 command 

U-144 
screen, $B operator command 
U-12 
CLOSE Host Communications Facili- 
ty, TP operand C-90 
CLSRU (close tape data set) L-75 
cluster, indexed data set S-200 
CM copy member 

$C0PYUT1 command U-64 
§DIUTIL command U-155 
CMDEQU L-12 
CMDSETUP 1-13, 1-67 
CNG copy all members 
(non-generi c) ,$C0PYUT1 command 
U-64 
CO command, $RJE2780/$RJE3780 

C-76 
COBOL 

execution requirements S-23 
link editing S-71 
overview S-7 
program preparation 
requirements S-23 
use with Multiple Terminal 
Manager C-193 
code translation 

new support tables I-lll 
terminal I/O layer 2 1-109 
code words, task L-8 
COLS display columns, $FSEDIT line 

command U-228 
command area, $EDXASM 1-214 
command descriptions U-235 
COMMAND send to host, 

$RJE2780/$RJE3780 C-75 
command table 1-68, 1-282, 1-301 
common data area (see $SYSCOM) 
common emulator setup routine 
command table 1-13, 1-282, 

1-301 
operating conventions 1-67 
communication error function 

1-166 
communications utilities 
$BSCTRCE C-61 
$BSCUT1 C-62 
$BSCUT2 C-64 
$HFCUT1 C-107 
$PRT2780 C-72 
$PRT3780 C-72 
$RJE2780 C-73 
$RJE3780 C-73 
$RMU C-282 
communications utilities (session 

manager) S-217, U-42 
communications vector table I-ll, 

1-278, 1-313 
compiler (see $EDXASM) 
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completion codes (see return 
codes) 

$EDXASM U-436 
$IAMUT1 U-437 
$JOBUTIL U-439 
$LINK U-^40 
$UPDATE U-443 
compress 

data base, CP $DIUTIL command 

U-154 
library, $COMPRES utility 
U-57 
compressed byte string S-309 
CONCAT graphics instruction 
coding description L-72 
overview L-26 
concatenating indexed data sets 

S-167 
concurrent access L-27 
concurrent execution L-^2 
configuration statements S-75 
configure terminal CT $TERMUT1 

command U-335 
connecting an indexed data set 

S-159 
continuation, source program line, 

$EDXASM U-361 
control, device instruction level 

L-24 
control block (see DSCB) 
control block and parameter 
tables 

BSCEQU 1-133, 1-291, L-11 
CCBEQU (see also CCB) L-11 
CMDEQU (see also emulator 

command table) L-12 
DDBEQU 1-92, 1-308, L-12 
DSCBEQU (see also DSCB) L-12 
ERRORDEF L-12 
FCBEQU A-20, L-12 
lANEQU L-12 
PROGEQU 1-312, L-13 
referencing 1-289 
TCBEQU (see also TCB) L-13 
control block module (ASMOBJ) 

description 1-76 
CONTROL IDCB command L-175 
control keys for text editors 

U-172 
control records, $LINK U-396 
control statements, program 
listing L-28 
task L-42 

terminal I/O forms control 
L-45 
CONTROL tape instruction L-74 
conversi on 

algorithm for graphics 1-201 

alphameric data L-152 

def i ni ti on 

EBFLCVT module description 

1-80 
floating point/binary 1-205 
numeric data L-148 
program modules by $UPDATE/H 

U-418 
terminal I/O binary/EBCDIC 
I-llO 
CONVTB data formatting 
i nstruct i on 

coding description L-79 
internals 1-207 
overview L-18 
CONVTD data formatting 
i nstructi on 



coding description L-82 
internals 1-207 
overview L-18 
copy 

block of text, CO $FSEDIT line 

command U-226 
data members, all, CAD 

$C0PYUT1 command U-64 
data set, CD $COPY command 

U-61 
data sets with allocation, 

$C0PYUT1 utility U-64 
line of text, C $FSEDIT line 

command U-226 
member 

CM $C0PYUT1 command U-64 
CM $DIUTIL command U-155 
members 

all, CALL $C0PYUT1 com- 
mand U-64 
generic, CG $C0PYUT1 

command U-64 
non-generic, CNG $C0PYUT1 
command U-64 
programs, all, CAP $C0PYUT1 

command U-64 
text, $EDIT1/N editor 

subcommand U-186 
volume, CV $COPY command U-62 
copy code library, instruction 

parsing ($EDXASM) 1-222 
COPY instruction 

coding description L-86 
overview L-33 
Count record C-256 
CP compress data base, $DIUTIL 

command U-154 
CR invoke $DISKUT1, $IAMUT1 

command U-236 
create 

character image tables, $FONT 

U-205 
source data set, $FSEDIT 

U-214 
supervisor for another 

Series/1 S-132 
unique labels, $SYSNDX 
($EDXASM) 1-242 
create indexed data set S-156 
cross partition instructions 1-71 
cross partition services S-286 
CSECT list, supervisor 
Version 1.1 S-347 
Version 2 S-357 
CSECT program module sectioning 
statement 

coding description L-87 
overview L-33 
CT 

change tape drive attributes, 

$TAPEUT1 command U-315 
configure terminal, $TERMUT1 
command U-335 
CV 

change output volume U-409 
$UPDATE command U-409 
$UPDATEH command U-418 
change volume 

$BSCUT1 command C-62 
$C0PYUT1 command U-64 
§DISKUT1 command U-137 
$DISKUT2 command U-143 
copy volume, $C0PY command 
U-59 
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CYCLE 

coding description C-132, 
L-365 

internals 11-9 

overview C-116, L-29 
cylinder S-60 
cylinder track sector (CTS) U-135 



D delete line, $FSEDIT line com- 
mand U-228 
D/I (see digital input) 
D/0 (see digital output) 
data 

conversion (see conversion) 
conversion specifications (see 

also conversion) L-146 
definition statements L-17 
files for $S1ASM 1-254 
floating-point arithmetic 

instructions L-20 
formatting functions L-18 
formatting instructions L-18 
integer and logical 
instructions L-19 
length of transmitted, host 

communications 1-159 
management S-45 
management system. Indexed 

Access Method L-27 
manipulation instructions 

L-19 
record contents, text editor 

1-325 
representation L-20 

floating-point L-20 
integer L-19 
terminal input L-45 
terminal output L-45 
transfer initialization, 

terminal I/O support 1-112 
transfer rates. Host 

Communications Facility C-84 
transfer ready, (DTR) BSCOPEN 
1-148 
Data Collection Interactive S-11 
DATA data definition statement 
coding description L-88 
overview L-17 
data management utilities 
$COriPRES S-64, U-57 
$COPY S-64, U-59 
$C0PYUT1 S-64, U-64 
$DASDI S-64, U-68 
$DISKUT1 S-64, U-135 
$DISKUT2 S-64, U-142 
$DISKUT3 S-315 
$IAMUT1 S-148, U-235 
$INITDSK S-64, U-256 
$MOVEVOL S-65, U-294 
$PDS S-247 
$TAPEUT1 U-311 
session manager S-215, U-38 
data manipulation, vector L-19 
data manipulation instructions 

L-19 
Data record C-257 
data representation, terminal I/O 

L-45 
data set 

allocati on/deleti on 



$DISKUT1 U-137 
$DISKUT3 S-315 
$JOBUTIL U-273 
$PDS S-248 
session manager U-29 
characteristics, HCF C-83 
format 

$FSEDIT U-210 
$PDS S-249 
$PRT2780 C-72 
$PRT3780 C-72 
naming conventions C-82, S-56 
transfer 

RECEIVE function C-243 
SEND function C-247 
utilities (see data management 
uti li ti es) 
data set naming conventions. Host 

Communications Facility C-82 
data-set-shut-down condition 

S-179 
date/time 

display, $W operator command 

U-25 
set, $T operator command U-19 
DC data definition statement 
coding description L-88 
overview L-17 
DCB EXIO control statement 
coding description L-91 
overview L-24 
DCE directory control entry 

format 1-88 
DCI (Data Collection Interactive) 

S-11 
DD block delete, $FSEDIT line 

command U-228 
DDB disk data block 
description 1-92 
equate table 1-308 
DDBEQU L-12 
DE delete member 

$DISKUT1 command U-137 
$DIUTIL command U-156 
delete data set, $JOBUTIL 
command U-274 
deadlocks C-238, S-180 
debug 

$EDXASM overlay programs 

1-248 
aids (see also diagnostic 

aids) S-18 
facility, $DEBUG utility U-82 
def i ne 

horizontal tabs, HTAB $IMAGE 

command U-252 
image dimensions, DIMS $IMAGE 

command U-251 
indexed data set, DF $IAMUT1 

command U-237 
null representation, NULL 

$IMAGE command U-253 
vertical tabs, VTAB $IMAGE 
command U-254 
DEFINEQ queue processing 
statement 

coding description L-94 
overview L-37 
definition statements, data L-17 
delete 

data set 

$JOBUTIL command U-274 
DELETE function C-216 
tape data set, TA $TAPEUT1 
command U-333 
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elements^ IN $DICOMP command 

U~107 
member 

$PDS S~261 

DE $DISKUT1 command U-137 
DE $DIUTIL command U-156 
text 

$EDIT1(N) editor subcom- 
mand U-188 
line, D $FSEDIT line 
command U-228 
with SPREFIND U-305 
DELETE function C-216, 1-166, 

1-174 
DELETE instruction 

coding description L-329 
overview L-27, S-147 
return codes L-330 
DEQ task control instruction 
coding description L-95 
internals 1-59 
overview L-42, S-33 
supervisor function 1-46 
DEQBSC dequeue BSC DDB routine 

1-149 
DEQT terminal I/O instruction 
coding description L-97 
overview L-44, S-47 
DETACH task control instruction 
coding description L-98 
internals 1-45 
overview L-42, S-30 
detached, task supervisor 

execution state 1-43 
device 

busy (EXOPEN) L-129 

data block description, EXIO 

1-123 
instruction level control 

L-24 
interrupt handling, EXIO 

1-125 
test utility, $IOTEST U-263 
vector table I-ll, 1-278 
DF define indexed file, $IAMUT1 

command U-237 
DI (see digital input) 
diagnostic 

aids S-265 

summarized S-18 
uti li ti es 

$DEBUG U-82 
$DUriP U-163 
$IOTEST U-263 
$LOG U-292 
$TRAP U-348 
with session manager 
S-217, U-38 
digital input 

$IOTEST command U-266 
digital I/O control block 

1-129 
direct output, $DICOMP subcom- 
mand U-112 
direct output to another 

device ($PDS) S-255 
display parameters, $IAMUT1 

command U-239 
external sync, XI $IOTEST 

command U-266 
lODEF statement L-186 
overview S-48 
SBIO instruction L-265 
SENSORIO configuration 
statement S-84 



digital output 

digital I/O control block 

1-129 
DO $IOTEST command U-265 
external sync, XO $IOTEST 

command U-266 
lODEF statement L-186 
overview S-48 
SBIO instruction L-267 
SENSORIO configuration 
statement L-84 
DIMS define image dimensions, 

$IMAGE command U-251 
direct access common I/O module, 

DISKIO, description 1-77 
direct access storage device 

organization S-52 
direct output, DI $DICOMP 

subcommand U-112 
di rectory 

control entry (DCE) 1-88 
entries S-249 
member entry (DME) 1-89 
disaster recovery from tape, RT 

$TAPEUT1 command U-326 
DISCONN Indexed Access Method 
CALL 

coding description L-332 
overview L-27, S-148 
return codes L-333 
DISCONNECT Multiple Terminal 

Manager utility C-119, C-159 
disconnecting an indexed data set 

S-159 
DISK configuration statement S-78 
di sk/di skette 

capacity S-58 
data block (DDB) 1-92 
fixed-head S-15, S-61 
I/O task 1-95 
IPL S-16, S-61 
primary volume S-60 
resident loading code 1-19 
secondary volume S-60 
symbolic addressing L-10 
uti li ties 

$COMPRES S-64, U-57 
$COPY S-64, U-59 
$C0PYUT1 S-64, U-64 
$DASDI S-64, U-68 
$DISKUT1 S-64, U-135 
$DISKUT2 S-64, U-142 
$DISKUT3 S-315 
$IAMUT1 S-148, U-235 
$INITDSK S-64, U-256 
$MOVEVOL S-65, U-294 
$PDS S-247 
utility function table U-49 
volume S-16, S-52 
disk I/O instructions L-22 
DISKIO direct access common I/O 

module description 1-77 
display (see also list) 

character image tables, DISP 

$FONT command U-205 
contents of storage or 
registers, LIST $DEBUG com- 
mand U-95 
control member ($PDS) S-250 
control member format ($PDS) 

S-252 
initial data values for image 

S-303 
processor composer, $DICOMP 
U-105 
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processor interpreter* 

$DIINTR U-150 
processor utility, $DIUTIL 

U-150 
processor utility, general 

description U-'105 
profile elements ($PDS) S-252 
protected and null fields of 

an image S-302 
report line items ($PDS) 

S-255 
status of all tasks, WHERE 

$DEBUG command U-102 
storage, $D operator command 

S-63, U-15 
time and data, TD ($PDS) 

S~258 
time and date, $W operator 

command S-63, U-25 
utility program set ($PDS) 

S-248 
variable, VA($PDS) S-254 
4978 program function keys, 
$PFMAP utility U-301 
DISPLAY TERMCTRL function L-288 
DIVIDE data manipulation 
i nstructi on 

coding description L-99 
overview L-19 
precision table L-lOO 
DME di rectory member entry 
format 1-89 

updated by SETEOD S-324 
DO 

digital output (see digital 

output) 
program sequencing 
instruction 

coding description L-101 
overview L-3<^ 
double-precision L-19 

floating-point arithmetic 

L-21 
integer and logical L-19 
DOWN move line poiner, $EDIT1/N 

editor subcommand U-189 
DP 

dump to printer 

$DISKUT2 command U-144 
$TAPEUT1 command U-317 
print trace file, $BSCUT1 
command C-62 
DR draw symbol, $DICOMP 

subcommand U-112 
DR draw symbol ($PDS) S-254 
draw 

line, LI $DICOMP subcommand 

U-120 
line relative LR ($PDS) S-257 
symbol, DR $DICOMP subcommand 
U-112 
DS data set identifier, $JOBUTIL 

command U-275 
DSCB data set control block 
statement 

coding description L-105 
equate table, DSCBEQU 1-311 
for tape, internals 1-99 
internals 1-92 
overview L-22 
DSCBEQU L-12 
DSECT (see control block and 

parameter equate tables) L-11 
DSOPEN subroutine 

description S-322 



DSR data set ready in BSCOPEN 

1-148 
DTR data transfer ready in 

BSCOPEN 1-148 
DU 

dump on terminal, $DISKUT2 

command U-144 
dump trace file on terminal, 
$BSCUT1 command C-62 
dump 

restore volume utility 

$nOVEVOL U-294 
storage partition, DUMP 

function C-218 
to printer 

$DUMP utility U-163 
DP $DISKUT2 command U-143 
DP $TAPEUT1 command U-317 
PR $DICOMP command U-108 
to terminal 

$DUMP utility U-163 
DP $TAPEUT1 command U-317 
DU $DISKUT2 command U-143 
PR $DICOMP command U-108 
trace file on printer, DP 

$BSCUT1 command C-62 
trace file on terminal, DU 
$BSCUT1 command C-62 
DUMP function C-218, 1-166, 1-175 
D4969, tape device handler module 
description 1-82 
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E-conversion (Ew.d) L-150 
EBFLCVT, EBDIC to floating-point 
conversion 1-205 

module description 1-80 
EC control echo mode, $IAMUT1 

command U-240 
ECB task control statement 

coding description L-107 
internals 1-55 
overview L-42, S-30 
with SBIOCB 1-128 
EDIT 

begin editing source data, 

$EDIT1/N command U-174 
create or change data set, 

$FSEDIT option U-214 
enter edit mode, $FONT 

command U-205 
enter edit mode, $IMAGE 
command U-251 
edit data set subroutine examples, 

text editor 1-326 
editor subcommands, $EDIT1/N 

U-182 
EDL (see Event Driven Language) 
compiler ($EDXASM) U-356 
instruction format 1-67 
interpreter, EDXALU, module 

description 1-77 
operation codes 1-67 
EDXALU Event Driven Language 
interpreter description 1-5, 
1-77 
EDXFLOAT floating-point operations 

module description 1-79 
EDXINIT supervisor initialization 
control module 1-15 
description 1-81 
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EDXLIST host listing formatter 

U-383 
EDXSTART supervisor initialization 

task module description 1-81 
EDXSVCX/EDXSVCXU task supervisor 
addr. trans, support desc 1-5, 
1-76 
EDXSYS system data tables, 

description 1-75 
EDXTIMER 7840 timer feature card 

module description 1-80 
EDXTIMR2 4952 timer module 

description 1-80 
EDXTIO terminal I/O 

EDXTIO/EDXTIOU module 

description 1-78 
internals 1-105 
EJECT listing control statement 
coding description L-109 
overview L-28 
eject printer page 

$E operator command U-16 
ELSE program sequencing 
instructi on 

coding description L-110, 

L-178 
overview L-34 
emulator (see 

supervi sor/emulator) 
emulator command table 1-13, 

1-282, 1-301 
emulator functional flow 1-69 
emulator setup routine 1-67 

command table 1-13, 1-282, 
1-301 
EN end program, $IAMUT1 command 

U-235 
END 

$LINK control record U-396 
option selection, $EDXASM 

command U-358 
option selection, $EDXLIST 

command U-371 
option selection, $S1ASM 

U-378 
primary command input, $FSEDIT 

primary command U-221 
task control statement 

coding description L-111 
overview L-42 
end display, EP $DICOMP 

subcommand U-118 
end-of-file, indicating with 

SETEOD S-324 
ENDATTN task control instruction 
coding description L-112 
overview L-42, S-30 
ENDDO program sequencing 
instructi on 

coding description L-103, 

L-113 
overview L-34 
ENDIF program sequencing 
i nstructi on 

coding description L-114, 

L-178 
overview L-34 
ENDPROG task control statement 
coding description L-115 
overview L-42, S-30 
ENDSEQ Indexed Access Method CALL 
coding description L-334 
overview L-27, S-147 
return codes L-335 



ENDSPOOL switch spool to print, 

$RJE2780/$RJE3780 C-75 
ENDTASK task control instruction 
coding description L-116 
overview L-42, S-30 
ENQ task control instruction 
coding description L-117 
internals 1-60 
overview L-42, S-33 
supervisor function 1-45 
ENQT terminal I/O instruction 
S-293 

coding description L-119 
overview L-44, S-47 
enqueue, task supervisor function 

(see ENQ) 
entering and editing source state- 
ments S-66, U-192 
entry points, supervisor 
Version 1.1 S-347 
Version 2 S-357 
ENTRY program module sectioning 
statement 

coding description L-121 
overview L-33 
EOF (end-of-file) L-74 
EOJ end of job, $JOBUTIL command 

U-276 
EOP end of nested procedure, 

$JOBUTIL command U-276 
EOR data manipulation instruction 
coding description L-122 
overview L-19 
EOT (end-of-tape) L-41 
EP end display, $DICOMP 

subcommand U-118 
EQ (equal) L-34 
EQU data definition instruction 
coding description L-124 
overview L-17 
equate tables 

$EDXASM compiler common area 

1-214 
BSCDDB, BSC line control 

block 1-291 
CCB, terminal control block 

1-292 
DDB, disk/diskette control 

block 1-308 
DDB for sensor I/O 1-309 
DSCB, data set control block 

1-311 
emulator command table 1-282, 

1-301 
Indexed Access Method A-19 
parameter and control block 

L-11 
program header 1-312 
referencing 1-30 
supervisor 1-279, 1-313 
TCB, task control block 1-314 
ERASE terminal I/O instruction 
coding description L-126 
overview L-44, S-47 
error codes (see return codes) 
error handling 

I/O error logging S-270 
Indexed Access Method error 

exit S-178 
Remote Management Utility 

C-277 
software trace S-265 
task error exit S-33, S-268 
terminal I/O L-44 
ERRORDEF L-12 
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ERRORS list error option 
$EDXASM command U-358 
$EDXLIST command U-370 
estimating storage (see storage 

estimati ng) 
event control block (see ECB) 
Event Driven Language (see EDL) 
EX exercise tape, $TAPEUT1 com- 
mand U-319 
EXEC function C-220, 1-166, 1-178 
EXEC load and execute program, 

$JOBUTIL command U-277 
execute program 

EXEC function C-220 
PASSTHRU function C-225 
SHUTDOWN function C-251 
utilities (session manager) 
S-216 
executing, task supervisor exe- 
cution state 1-^3 
exercise tape, EX $TAPEUT1 

command U-319 
EXFLIH command start 1-125 
EXIO control instruction 

coding description L-128 
EXIODDB device data block 

description 1-123 
internals 1-125 
overview L-24, S-51 
EXIOCLEN, EXIO termination module 

1-126 
EXIODEV configuration statement 

S-82 
EXIOINIT, system initialization 

1-125 
EXOPEN EXIO control instruction 
coding description L-129 
internals 1-125 
interrupt codes L-132 
overview L-24 
return codes L-131 
external sync DI/DO, XI/XO $IOTEST 

command U-266 
EXTRACT, Indexed Access Method 
CALL 

coding description L-336 
overview L-26, S-148 
return codes L-337 
EXTRN program module sectioning 
statement 

coding description L-134 
overview L-33 



F-conversion (Fw.d) L-149 
FADD data manipulation 
i nstructi on 

coding description L-135 
overview L-19 
return codes L-136 
FAN, Multiple Terminal Manager 
CALL 

coding description C-139, 

L-366 
overview L-31 
FCA file control area. Multiple 

Terminal Manager C-143 
FCB file control block for Indexed 
Access Method 

definition A-9, A-20 
description A-11, A-21, S-194 



location A-20 

map provided by FCBEQU S-155 
FCBEQU Indexed Access Method copy 

code module L-12, S-155 
FDIVD data manipulation 
i nstructi on 

coding description L-137 
overview L-19 
return codes L-138 
FETCH Host Communications 

Facility, TP operand C-92 
fetch record ($PDS) S-261 
fetch status, FE $HCFUT1 command 

C-110 
file L-75 

backward space file (BSF) 

L-75 
control area (see FCA) 
control block (see FCB) 
definition L-40 
forward space file (FSF) L-75 
manager. Multiple Terminal 

Manager M-8 
tape control commands L-75 
FILEIO, Multiple Terminal Manager 
CALL 

coding description C-141, 

L-367 
internals M-9 
overview C-118, L-29 
FIND 

editor commands 

character string, $EDIT1/N 

subcommand U-191 
character string, $FSEDIT 
primary command U-222 
program sequencing 
instructi on 

coding description L-139 
overview L-34 
FINDNOT program sequencing 
i nstructi on 

coding description L-141 
overview L-34 
FIRSTQ queue processing 
instructi on 

coding description L-143 
overview L-37, S-32 
fixed-head devices S-61 
fixed storage area, contents 1-9 
floating-point 

arithmetic instruction 
equates 1-283, 1-303 
arithmetic instructions L-20 
binary conversions 1-205 
command entries module, 

NOFLOAT, description 1-79 
operations module, EDXFLOAT, 

description 1-79 
return codes L-21 
FMULT data manipulation 
instructi on 

coding description L-144 
overview L-19 
return codes L-145 
format 

illustrated L-5 
instruction (general) L-3 
FORMAT data formatting statement 
»A' 

'F' 
'H» 
»I' 
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conversi on 
conversi on 
conversi on 
conversi on 
conversi on 



L-153 
L-150 
L-149 
L-152 
L-148 
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conversion of alphameric data 

L-153 
conversion of numeric data 

L-148 
data conversion specifica- 
tions L-146 
module names L-18 
multiple field format L-155 
overview L-18 
repetitive specification 

L-155 
using multipliers L-155 
X-type format L-154 
formatted screen images S-300» 

U-250 
formatting instructions* data 

L-18 
forms control 

burst output with electronic 

di splay screens L-46 
forms interpretation L-46 
output line buffering L-46 
parameters* terminal I/O L-44 
terminal I/O L-45 
FORTRAN IV 

execution requirements S-24 
link editing S-71 
overview S-6 
program preparation 
requirements S-24 
use with Multiple Terminal 
Manager C-197 
FPCONV data manipulation 
i nstructi on 

coding description L-157 
overview L-19 
free pool in Indexed Access 

Method L-27 
free space 

definition S-148 
estimating S-168 
in Indexed Access Method L-27 
free space entry 1-90 
FREEMAIN storage allocation 

function 1-25 
FSE free space entry 1-90 
FSR (forward space record) L-75 
FSUB data manipulation 
i nstructi on 

coding description L-159 
index registers L-160 
overview L-19 
return codes L-160 
FTAB* Multiple Terminal Manager 
CALL 

coding description C-138» 

L-372 
overview C-124, L-31 
return codes L-373 
full-screen static configuration 

S-293 
full-screen text editor host and 

native, $FSEDIT U-209 
full-word boundary requirement 
DO L-34 
IF L-34 
PROGRAM L-225 
function process overlays 1-162 
function process subroutines 
1-162, 1-170 

new subroutines 1-187 



function table 1-164, 1-167 
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GE (greater than or equal) L-34 
general instruction format L-3 
generating the supervisor S-115 
GENxxx>? macro 1-120 
GET Indexed Access Method CALL 
coding description L-338 
overview L-27, S-147 
return codes L-340 
GETEDIT data formatting 
i nstructi on 

coding description L-162 
overview L-18 
GETMAIN storage allocation 

instruction 1-25 
GETPAR3 1-69 

GETSEQ Indexed Access Method CALL 
coding description L-342 
overview L-27, S-147 
return codes L-343 
GETSTORE TERMCTRL function L-288 
GETTIME timing instruction 

coding description L-167 
overview L-50, S-32 
GETVAL subroutine, $EDXASM 1-234 
GETVALUE terminal I/O instruction 
coding description L-169 
overview L-44, S-47 
GIN graphics instruction 

coding description L-172 
overview L-26 
global area, $EDXASM 1-224 
GLOBAL ATTNLIST L-61 
GO activate stopped task, $DEBUG 

command U-93 
GOTO 

change execution sequence, 

$DEBUG command U-94 
coding sequencing instruction 
coding description L-173 
overview L-34 
graphics 

conversion algorithm 1-201 
functions overview L-26 
hardware considerations C-6, 

C-300 
instructions L-26 
CONCAT L-72 
GIN L-172 
PLOTGIN L-210 
SCREEN L-270 
XYPLOT L-324 
YTPLOT L-325 
requirements L-26 
terminals S-46 
uti li ti es 

$DICOMP U-105 
$DIINTR U-127 
$DIUTIL U-150 
session manager S-216, 

U-40 
summarized S-64, U-5 
GT (greater than) L-34 
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H-conversion L-152 

hardcopy function for terminals 

PF6 1-114, U-7 
hardware levels S-30 
HCF (see Host Communications 

Faci li ty) 
HDRl tape label S-239 
header labels, tape S-235 
header record 

Remote Management Utility 
C-209 
header record format, text editor 

1-323 
HELP list debug commands, $DEBUG 

command U-94 
highei — level index block S-197 
horizontal tabs, defining with 

$IMAGE U-252 
host assembler U-382 
Host Communications Facility 
C-81, 1-153 

data set naming conventions 

C-82 
Program Preparation 

System/370 1-153, U-382 
TPCOM module description 1-81 
utility program, $HCUT1 C-107 
host program. Remote Management 

Utility C-205 
host system considerations C-83 
HOSTCOMM configuration statement 

S-83 
HX display hex words, $DICOMP 
subcommand U-118 



initialization, $INITDSK com- 
mand U-257 
insert line, $FSEDIT line 
command U-229 
I-conversion (Iw) L-148 
I/O device instruction level L-24 
I/O error logging 

data set list utility, 

$DISKUT2 U-142 
device table S-276 
invoking S-273, U-292 
log control record S-276 
log data set U-292 
LOG macro 

equates S-278 
syntax S-272 
printing the errors S-275 
recording the errors S-270 
tape log entries S-245 
utility, $LOG U-292 
I/O functions 

disk/diskette 1-95, L-22 

summarized S-46 
EXIO control 1-123, L-24 

summarized S-51 
HOSTCOMM configuration 
statement L-39, S-83 
overview S-45 
sensor 1-127 

summarized S-51 



tape L-40, L-75 
terminal S-46 
timers L-50, S-32 
I/O instructions 
disk L-22 
diskette L-22 
tape L-40 
lACB indexed access control block 
built by connecting data set 

S-159 
definition A-20 
description A-35 
location A-14 
lAM Indexed Access Method link 

module S-155 
lAMEQU Indexed Access Method copy 

code module L-12, S-155 
IDCB EXIO control statement 
coding description L-175 
overview L-24 
IDCHECK function C-223, 1-166, 

1-177 
identification, verify 
host system C-223 
IDCHECK function C-223 
remote system C-223 
IF program sequence instruction 
coding description L-177 
overview L-34 
II insert block, $FSEDIT line 

command U-231 
IIB interrupt information byte. 

Multiple Terminal Manager C-128 
IM insert member 

$DICOMP subcommand U-118 
$PDS S-257 
image dimensions, define, DIMS 

$IMAGE command U-251 
image store U-205 
immediate action routines 1-46 
binary synchronous access 

method 1-149 
specifying maximum number 

S-88 
task supervisor 1-48 
immediate data L-4 
IN 

initialize data base, $DIUTIL 

command U-157 
insert or delete elements, 
$DICOMP command U-107 
INCLUDE $LINK control record 

U-398 
INCLUDE statement requirement 

(EXTRN) L-134 
index block A-20, A-33 

overview S-151 
index entry A-12 
index record contents, text 

editor 1-323 
index registers 

floating-point operations 

using L-21 
integer operations using L-19 
software introduction L-6 
indexed access control block (see 

lACB/ICB) 
Indexed Access Method L-26, L-327 
$IAM load module S-155 
$IAMUT1 utility U-235 
overview S-148 
parameters S-187 
used i n data set 
reorganization S-166 
application program 
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preparation 

ejOBUTIL procedure S-158 
link edit control S-158 
CALL instruction syntax L~68, 

S-146 
CALL processing A-4 
coding instructions L-327 
control block linkages A-15 
control flow A-3 
data block location 

calculation A-9 
devices supported by S-146 
diagnostic aids A-10 
I/O requests 

DELETE L-329, S-147 
DISCONN L-332, S-148 
ENDSEQ L~334, S-147 
EXTRACT L-336, S-148 
GET L-338, S-147 
GETSEQ L-341, S-147 
LOAD L-344, S-147 
PROCESS L-347, S-147 
PUT L-350, S-147 
PUTDE L-352, S-147 
PUTUP L-354, S-147 
RELEASE L-356, S-147 
JAM link module S-155 
operation S-148 
ov^rvieui L-27, S-145 
performance S-205 
program preparation procedure 

S-155 
record processing A-6 
request processing A-5 
request verification A-10 
storage requirements S-204 
indpxed applications* planning and 
flesigning 

connecting and disconnecting 

data sets S-159 
handling errors 

data-set-shut-down condi- 
tion S-179 
deadlocks S-180 
error exit facilities 

S-178 
long-lock-tirae condition 

S-180 
system function return 
codes S-179 
loading base records S-160 
processing indexed data sets 
delete S-165 
direct read S-161 
direct update S-162 
extract S-165 
insert S-146 
sequential read S-162 
sequential update S-146 
resource contention S-181 
if^fliBxed data set 
1 l9Bse records S-149 
building U-247 
concatenating with ALTIAM 

subroutine S-167 
control block arrangement A-8 
creation with $IAMLIT1 utility 
U-236 

formatting S-187 
procedure S-156 
design A-7 
determining size and format 

U-247 
format 

blocks S-192 



cluster S-200 

data block S-194 

file control block (FCB) 

S-151, S-194 
free blocks S-200 
free pool S-203 
free records S-200 
free space S-184 
highei — level index block 

S-197 
index S-195 
index block S-194 
introduction S-151 
last cluster S-203 
primary-level index block 

(PIXB) S-152, S-195 
relative block number 

(RBN) S-152 
reserve blocks S-201 
reserve index entries 

S-202 
second-level index block 

(SIXB) S-152, S-197 
sequential chaining S-203 
loading and inserting records 

S-150 
mai ntenance 

backup and recovery S-165 
deleting S-167 
dumping S-167 
recovery without backup 

S-166 
reorganization S-166 
overview S-148 
physical arrangement A-8 
preparing the data 

defining the key S-166 
estimating free space 

S-168 
selecting the block size 
S-167 
putting records into S-149 
RBN, relative block number 

A-7, A-12 
record locking S-146, S-160 
verification A-11 
indexed data set, defining U-237 
indexed file (see Indexed Access 
Method) 

indexing, address feature L-6 
initial program load (see also 

IPL) 1-15 
ini tiali zati on 

automatic application S-129 
disk (4962) U-68, U-73 
disk (4963) U-68, U-78 
diskette (4964,4966) U-68 
libraries, $INITDSK utility 

U-256 
modules 1-16 
nucleus 1-15 
Remote Management Utility, 

internals 1-166, 1-171 
tape, $TAPEUT1 utility U-322 
task 1-15 
initialize data base, IN $DIUTIL 

command U-157 
initializing secondary volumes 

S-132 
INITMODS, initialization modules 

1-16 
INITTASK, initialization task 

1-15 
input, terminal I/O L-46 
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IM $DICOMP subcommand 
address register (see 
and statements - ovei — 



supervi sor 



Input Buffer, Multiple Terminal 
Manager C-116 

contents during 4978/4979/3101 

buffer operation C-129 
description C-116 
input data parsing, description 

of 1-218 
Input Error function 1-166, 1-182 
input/output (see I/O) 
input output control block (see 

lOCB) 
INPUT switch to input mode, 

$EDIT1/N editor subcommand U-192 
i nsert 

block, II $FSEDIT line com- 
mand U-231 
elements, IN $DICOMP command 

U-107 
line, I $FSEDIT line command 

U-229 
member, 
U-118 
i nstructi on 

lAR) 
i nstructi on 
view L-15 
instruction definition and 
checking ($EDXASM) 1-241 
instruction format. Event Driven 

Language 1-67, L-3 
instruction format, general L-3 
instruction operands L-3 
integer and logical instructions 

L-19 
interactive program debugging 

S-67, U-82 
interface routines, 

1-61 
i nterprocessor communications 

C-29 
interprogram dialogue S-282 
interrupt, from EXIO device 1-125 
interrupt information byte (see 

IIB) 
interrupt line S-313 
interrupt servicing 1-46, 1-113 
INTIME timing instruction 

coding description L-181 
overview L-50, S-32 
introduction to EDL L-1 
invoking the loader 1-23 
invoking the session manager U-27 
invoking the utilities U-47 
lOCB terminal I/O instruction 
coding description L-183 
constructing, for formatted 

screen ($IMDEFN) S-301 
overview L-44, S-47 
structure S-296 
terminal I/O instruction 

L-183 
TERMINAL statement converted 
to S-96 
lODEF sensor based I/O statement 
U-364 

coding description L-185 
overview L-39, S-51 
SPECPI - process interrupt 
user routine L-189 
lOLOADER, function of 1-127 
lOLOADER/IOLOADRU sensor based I/O 

init. module desc. 1-78 
lOR data manipulation instruction 
coding description L-191 
overview L-19 



IPL 

automat 

i zati o 

message 

dat 

IPL 

loa 

U- 

sen 

U- 

sto 

U- 
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vol 
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IPLSCRN, Mu 

Manager C 



ic application initial- 
n and restart S-129 
s U-421 
e and time U-425 

operation U-421 
d utility location 
424 

sor I/O status check 
424 

rage map generation 
423 

e initialization U-423 
ume initialization 
422 

re U-421 
Iti pie Termi nal 

125 



job U-278 

job control sta 

JOB job identif 

command U-278 
job stream proc 

S-69, U-271 
job stream proc 

(session manag 
JP 

jump ($PDS) 

to address, 

subcommand 

JR jump referen 

subcommand U- 
JUMP, $JOBUTIL 
jump reference, 

subcommand U- 
jump to address 

subcommand U- 



tement U-278 
ier, $JOBUTIL 

essor, $JOBUTIL 

essor utilities 
er) S-216 

S-255 

$DICOMP 
U-118 
ce, $DICOMP 
118 
command U-279 

JR $DICOMP 
118 

, JP $DICOMP 
118 



% .y 



key (see program function (PF) 

keys 
keyboard and ATTNLIST tasks, tei — 

mi nal I/O L-47 
keyboard define utility for 4978, 

$TERMUT2 U-339 
KEYS list program function keys 

$IMAGE command U-253 
keyword operand L-5 



LA 

display directory, $DIUTIL 

command U-158 
list all members, $DISKUT1 

command U-135, U-136 
list terminal assignment, 

$TERMUT1 command U-336 
label L-3 

field L-3 

syntax description L-4 
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LABEL end jump, $JOBUTIL command 

U-280 
labels, tape (see tape) 
LABELS subroutine, $EDXASM 1-238 
LACTS list all members CTS mode, 

$DISKUT1 command U-135 
language control data set, 

$EDXASM 1-221, U-357 
LASTQ queue processing 
i nstructi on 

coding description L-191 
overview L-37, S-32 
layers, terminal I/O 1-108 
LB display characters 

$DICOMP display character sub- 
command U-119 
$PDS S-252 
LC load control store, $TERMUT2 

command U-3^2 
LD 

list all hardware devices, 

$IOTEST command U-269 
list data members, $DISKUT1 
command U-138 
LDCTS list data members CTS mode, 

$DISKUT1 command U-135 
LE (less than or equal) L-34 
level status block (see LSB) 
LEIJORKI work data set for $LINK 

U-400 
LEW0RK2 work data set for $LINK 

U-400 
LH display member header, $DIUTIL 

command U-159 
LI 

draw line $DICOMP subcommand 

U-120 
draw line $PDS S-253 
load image store, $TERMUT2 
command U-3^2 
li brary 

definition S-52 
directory, disk or diskette 

1-87 
origin S-60 
li ne 

commands, $FSEDIT U-229 
continuation, source 

statement L-4 
editing, $EDIT1/N U-203 
pointer reposition (see move 

line pointer) 
source line continuation 
U-361 
LINK, Multiple Terminal Manager 
CALL 

coding description C-131, 

L-374 
internals M-9 
overview C-115, L-29 
link edit process, $LINK U-394 
autocall option U-393 
building an EDX supervisor 

U-394 
combining program modules 

U-392 
control records U-396 
elimination of duplication 

control sections U-393 
formatting modules for 

$UPDATE U-392 
input to $LINK U-396 
multiple control sections 

U-392 
object module record format 



U-407 
output from $LINK U-403 
storage map U-393 
link edit program object modules 

U-390 
link module. Indexed Access 

Method S-155 
linkage editor S-71, U-353 
LINKON, Multiple Terminal Manager 
CALL 

coding description C-132, 

L-376 
internals M-9 
overview C-115, L-29 
list 

active programs, $A operator 

command U-11 
breakpoints and trace ranges, 

BP $DEBUG command U-92 
characters, LB $DICOMP 

subcommand U-119 
data members, LD $DISKUT1 

command U-138 
data members, LDCTS $DISKUT1 

command U-135 
data set 

BROWSE $FSEDIT option 

U-213 
LP $DISKUT2 command U-143 
LU $DISKUT2 command U-146 
status, ST $DIUTIL 
command U-162 
date/time, $W operator 

command U-25 
date/time, TD $DICOMP 

subcommand U-124 
devices, LD $IOTEST command 

U-269 
end, EP $DICOMP subcommand 

U-117 
error specification, ERRORS 

$EDXASM command U-358 
hardware configuration, LD 

$IOTEST command U-264 
insert mask, MASK $FSEDIT line 

command U-232 
member, LM $DISKUT1 command 

U-138 
member, PR $DICOMP command 

U-108 
member header, LH $DIUTIL com- 
mand U-159 
members, all 

LA $DISKUT1 command U-135 
LA $DIUTIL command U-158 
LACTS $DISKUT1 command 
U-135 
processor program, $EDXLIST 

U-370 
program function key codes, 

$PFMAP utility U-301 
program function keys, KEYS 

$IMAGE command U-253 
program members, LP $DISKUT1 

command U-139 
program members, LPCTS 

$DISKUT1 command U-135 
status of all tasks, WHERE 

$DEBUG command U-102 
storage, $D operator command 

U-15 
termi nal 
names/types/addresses, LA 
$TERriUTl command U-335 
variables, VA $DICOMP 
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subcommand U-125 
volume information, VI $IOTEST 
command U-270 
LIST commands 
data set 

LIST $EDIT1/N command 

U-193 
LIST $FSEDIT option U-217 
display lines of text» 
$EDIT1/N editor subcommand 
U-193 
display storage or registers, 

$DEBUG command U-95 
lines of text, LIST $EDIT1/N 

editor command U-176 
list device option, $EDXASM 

command U-358 
list device option, $EDXLIST 

command U-370 
obtain full listing, LIST 

$EDXASM command U-358 
print data set, $EDIT1/N 

command U-176 
print data set, $FSEDIT 

option U-217 
registers, LIST $DEBUG 

command U-95 
storage, LIST $DEBUG command 
U-95 
listing control functions U-29 
listing control instructions 
EJECT L-109 
overview L-28 
PRINT L-216 
SPACE L-275 
TITLE L-308 
LISTP list to $SYSPRTR, $DISKUT1 

command U-135 
LISTT list to terminal, $DISKUT1 

command U-135 
LL list log data set, $DISKUT2 

command U-145 
LM list member, $DISKUT1 command 

U-138 
LO load indexed file, $IAMUT1 

command U-2'^1 
LOAD 

Indexed Access Method CALL 

coding description L-3^^ 
connect file S-159 
overview L-27, S-146 
return codes L-346 
task control instruction 

coding description L-194 
internals 1-24 
overview L-42 
return codes L-199 
used with automatic 

initialization S-129 
used with overlays S-40 
load mode S-149 
load point defined L-40 
load program 

$L operator command 1-23, 

U-17 
automatic initialization 

S-129 
EXEC $JOBUTIL command U-277 
loading overlays 1-22 
loading programs 1-19 
locate data sets and overlay 

programs, $PREFIND U-302 
LOCATE locate requested line 
number $FSEDIT primary comman 
U-223 



location dictionary 1-250 
lock 

locks, block and record A-16 
locks, f i le A-17 
record S-146 
LOCK TERMCTRL function L-288 
LOG 

I/O error logging macro S-271 
job processor commands, 
$JOBUTIL command U-281 
log data set for I/O errors U-292 
logical end-of-file on disk S-324 
logical screens S-293 
logon menu for session manager 

S-212, U-27 
long-lock-time condition S-180 
low storage 

during IPL 1-16 
during program load 1-20 
LP 

list data set on printer, 

$DISKUT2 command U-144 
list program members, $DISKUT1 
command U-139 
LPCTS list program members CTS 
mode, $DISKUT1 command U-135 
LR draw line relative 

$DICOMP subcommand U-121 
$PDS S-257 
LS 

list space, $DISKUT1 command 

U-140 
list supervisor configuration, 
$IOTEST command U-270 
LSB level status block 1-52, 

U-427 
LT (less than) L-34 
LU list data set on console, 

$DISKUT2 command U-146 
LV list through volumes, $DISKUT1 
U-141 
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M move line, $FSEDIT line command 

U-233 
macro assembler 

internal overview $S1ASM 

1-253 
overview S-9 
macro library S-6 
macro library/host S-5 
magazine diskette (see 4966 

diskette magazine unit) 
magnetic tape (see tape) 
MASK display insert mask, $FSEDIT 

line command U-232 
master control block (see MCB) 
Mathematical and Functional Sub- 
routine Library S-6 
MCB master control block 
$PDS S-260 
definition A-20 
description A-28 
MD move data base, $DIUTIL 

command U-160 
member area S-250 
member control block (MCB) S-260 
MENU 

Multiple Terminal Manager 
CALL 

coding description C-137, 
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L-377 
internals ri-9 
overview C-116> L-29 
return to primary option, 
$FSEDIT U-223 
menu-driven U-2 
menus 

(see option selection menu) 
(see parameter selection 

menu) 
(see primary menu) 
(see primary option menu) 
(see secondary option menu) 
(see session manager, menus) 
(see transaction selection 
menu) 
MENUSCRN, Multiple Terminal Manag- 
er C-126 
MERGE merge data, $FSEDIT option 

U-217 
message, PRINTEXT instruction 

L-217 
message sending utility, $TERMUT3 

U-3^^ 
messages U-421 
error U-427 

$DUMP U-431 
$LOG U-432 
$RMU U-^33 
$TRAP U-435 
program check U-427 
system program check 
U-429 
IPL (see IPL messages) 
Multiple Terminal Manager 

C-178 
Remote Management Utility 
C-279 
minimum execution system config- 
uration S-22 
minimum program preparation 

requirements S-22 
mi rror i mage 

description C-7 , S-109 
in TERMINAL configuration 
statement S-101 
mixed precision combinations L-20 
MM move block, $FSEDIT line 

command U-233 
modified data S-307 
modify character image tables 

U-339 
modify character string, CHANGE 
$EDIT1/N editor subcommand 

U-184 
$FSEDIT primary command U-219 
modify default storage allocation, 

$DISKUT2 U-149 
modifying an existing data set, 

$FSEDIT U-215 
modifying TERMINAL statement for 

new I/O terminal 1-119 
module descriptions 
^$S1ASM 1-269 
supervisor 1-75 
module names and entry points, 
supervi sor 

Version 1.1 S-347 
Version 2 S-357 
move 

block, MM $FSEDIT line com- 
mand U-233 
line pointer 

BOTTOM $EDIT1/N editor 
subcommand U-183 



DOWN $EDIT1/N editor 

subcommand U-189 
TOP $EDIT1/N editor 

subcommand U-200 
UP $EDIT1/N editor 
subcommand U-201 
tape U-324 
text 

$EDIT1/N editor subcom- 
mand U-195 
$FSEDIT line command 
U-233 
volumes on disk or diskette, 
$MOVEVOL utility U-294 
MOVE data manipulation 
i nstructi on 

coding description L-201 
overview L-19 
MOVEA data manipulation 
i nstructi on 

coding description L-204 
overview L-19 
MOVEBYTE subroutine, $EDXASM 

1-236 
MP 

move beam, $DICOMP subcommand 

U-121 
move position ($PDS) S-253 
MT move tape, $TAPEUT1 command 

U-324 
MTMSTORE file. Multiple Terminal 

Manager C-120, C-171, M-12 
MTMSTR, Multiple Terminal Manager 

C-169, C-170, M-12 
multiple field format L-155 
multiple program execution 1-36 
multiple program structure S-26 
multiple-task programs 1-33 
Multiple Terminal Manager 

accessing the terminal envi- 
ronment block C-139, M-22 
application program C-116 
application program languages 

L-30 
application program manager 

C-119, M-4 
automatic OPEN/CLOSE C-140, 

M-8 
CALL 

ACTION C-130, L-360 
BEEP C-137, L-361 
CDATA C-139, L-362 
CHGPAN C-135, L-364 
CYCLE C-132, L-365 
FAN C-139, L-366 
FILEIO C-141, L-367 
FTAB C-138, L-372 
LINK C-131, L-374 
LINKON C-132, L-376 
MENU C-137, L-377 
SETCUR C-137, L-378 
SETPAN C-134, L-379 
WRITE C-133, L-381 
coding instructions L-359 
components C-123, M-4 
considerations for 3101 

terminal C-122 
data files C-120 

MTMSTORE file C-120, 

C-171, M-12 
PRGRMS volume C-120, 

C-173 
SCRNS volume C-120, C-173 
TERMINAL volume C-120, 
C-171 
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direct file request types 

C-l^<f, L-370 
disk file support C-140 
distribution and installation 

C-161 
dynamic screen modification 

and creation C-136 
file control area C-142 
file I/O considerations (Event 

Driven Executive) C-146 
file management C-118» M-8 
FILEIO» disk file support 

C-140 
FILEIO Indexed Access Method 

considerations C-148 
fixed screen formats C-125 
functions (callable routines) 

C-117, C-124 
indexed file request types 

C-144, L-369 
indexed file support C-140, 

L-367 
initialization programs 
C-119, C-158, M-4, M-6 
Input Buffer C-116, C-127 
Input Buffer Address C-116 
Input Buffer during 
4978/4979/3101 buffer oper- 
ation C-127 
interrupt information byte 

C-128 
messages C-178 
module list M-4 
operation C-115 
Output Buffer C-116 
Output Buffer Address C-127 
Output Buffer during 
4978/4979/3101 buffer oper- 
ation C-128 
overview L-29, S-10 
program management C-115, M-4 
program preparation 
COBOL C-166 
Event Driven Language 

C-164 
FORTRAN C-165 
PL/I C-167 
programming considerations 
COBOL C-153 
Event Driven Language 

C-151 
FORTRAN C-152 
PL/I C-155 
return codes (FILEIO) C-145, 

L-371 
screen definition C-121 
screen formats C-125 
IPLSCRN C-125 
MENUSCRN C-126 
SCRNSREP C-126 
SIGNONSC C-126 
screen panel manager M-7 
SIGNON/SIGNOFF C-156 

SIGNONFL C-174 
storage requirements C-168 
swap out data set C-116 
system generation 
considerations C-169 
data set requirements 

C-171, C-175 
volume requirements C-169 
terminal environment block 

(TEB) C-128, M-13 
TERMINAL file C-124, C-172 
terminal manager C-121 



terminal/screen management 

C-117 
terminal server C-119, M-7 
terminal support C-114, C-126 
transaction oriented 
applications C-121 
user application programs 

C-124 
utilities C-159 

DISCONNECT turn off 
specified terminals 
C-159 
programs report C-159 
RECONNECT turn on 
specified terminals 
C-159 
screens report C-160 
terminal activity report 
C-159 
work areas, control blocks and 
tables M-11 

buffer areas M-15, M-29 
common area M-11, M-25 
file table M-15, M-27 
MTMSTORE data set M-12 
program table M-14, M-21 
screen table M-14, M-21 
terminal environment block 

(TEB) M-13, M-22 
terminal table M-13, M-21 
MULTIPLY data manipulation 
i nstructi on 

coding description L-205 
overview L-19 
precision table L-206 
multi programmi ng 

automatic application initial- 
ization S-129 
design feature S-13 
multitasking 1-42 



NE (not 
newli ne 

1-112 

NEXTQ qu 

i nstruc 

codi 

over 

NOFLOAT 

entri es 

NOLIST n 

command 

NOMSG me 

$JOBUTI 

non-comp 

non-labe 

desc 

layo 

proc 

NOTE dis 

codi 

over 

notify o 

NQ reset 

command 

nucleus 

null cha 

NULL def 

$IMAGE 
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equal) L-34 
subroutine, terminal I/O 

eue processing 

ti on 

ng description L-207 

view L-37, S-32 

floating-point command 

module description I- 
o list option, $EDXASM 

U-358 
ssage suppression, 
L command U-282 
ressed byte string S-309 
led tapes 
ription S-241 
ut S-242 
essing S-243 
k/tape I/O instruction 
ng description L-209 
view L-22 
f an event (see POST) 

prompt mode, $C0PYUT1 
U-64 
initialization 1-15 
racter U-253 
ine null representation 
command U-253 
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null representation* defining 

U-253 
number representation conversion 

(see conversion) 



EZl 



object data set for $EDXASM U-357 
object module record format* 

$LINK U-407 
object text elements* format of» 

$EDXASM 1-215 
OFF (set tape offline) L-75 
OFF remove breakpoints and trace 

ranges* $DEBUG command U-97 
OLE operand list element* $EDXASri 
format of 1-216 
in instruction parsing 

($EDXASri) 1-220 
used in $IDEF 1-241 
online debug aids S-67 
op (operation field) L-3 
OPCHECK subroutine, $EDXASri 1-232 
opcode table* instruction parsing 

($EDXASM) 1-220* 1-223 
open a data set 

disk or diskette 1-90 
tape 1-99 
open EXIO device* EXOPEN 1-125 
open member ($PDS) S-261 
OPENIN Host Communications 

Facility* TP operand C-93 
OPENOUT Host Communications 
Facility* TP operand C-94 
operands 

defined L-3 
keyword L-5 

parameter naming (Px) L-8 
operating conventions* supervisor 

program 1-67 
operating environment S-22 
operation code* instruction 

parsing ($EDXASM) 1-220 
operation codes* Event Driven 

Language 1-68 
operations using index registers 

L-20 
operator commands S-63, U-9 
operator signals* terminal I/O 

L-49 
option selection menu U-33 
optional features support L-15 
OTE define object text element 

$EDXASM instruction 1-227 
OUTPUT $LINK control record U-399 
Output Buffer* Multiple Terminal 
Manager C-116* C-128 

contents during 4978/4979/3101 

buffer operation C-129 
definition M-29 
overflow L-20 
overlay function processor table 

1-167* 1-220 
overlay program S-40 

instructions* $EDXASM 1-259 
loading 1-22 
locating* $PREFIND U-302 
subroutines* $EDXASM 1-231 
user 1-38 
overlay program execution 1-38 
overlay selection* instruction 
parsing ($EDXASM) 1-223 



1-167, 1-220 

statements 
instructi ons 
module names 

L-19 



overlay table 
overvi ew 

data definition 

L-17 
data formatting 
L-18 

data format 
L-18 
data manipulation 
instructions L-19 

data representation 
mixed-preci si on 

operations L-20 
operations using index 

registers L-20 
overflow L-20 
vector L-19 
disk I/O instructions L-22 
EXIO control instructions 

L-24 
floating-point arithmetic 

L-20 
floating-point arithmetic 
instructions L-20 

data representation L-21 
operations using index 

registers L-21 
return codes L-21 
graphics instructions L-26 
Indexed Access Method 

instructions L-27 
instructions and statements 

L-15 
integer and logical 
instructions L-19 
listing control statements 

L-28 
Multiple Terminal Manager 

instructions L-29 
program control statements 

L-32 
program module sectioning 

statements L-33 
program sequencing 

instructions L-34 
queue processing L-37 
sensoi — based I/O statements 

L-39 
single-precision L-19 
system configuration 

statements L-39 
tape I/O instructions L-40 
task control instructions 

L-42 
terminal I/O instructions 

L-44 
timing instructions L-50 



P/I (see process interrupt) 
PA patch* $DISKUT2 command U-147 
page eject S-63* U-16 
parameter equate tables L-11 
parameter naming operands in the 

instruction format L-8 
parameter passing* Remote 

Management Utility C-212 
parameter selection menu U-33 
parameter tables* control block 

and L-11 



Common Index 507 



FARM program parameter passing, 

$JOBUTIL command U-283 
parsing, input data ($EDXASM) 

1-218 
partition assignment changing, $CP 

operator command U-1^ 
partitioned data sets S-247 
partitions S-42 
PASSTHRU function 

conducting a session C-227 
establishing a session C-225 
internals 1-166, 1-179 
overview C-225 
programming considerations 

C-237 
sample program C-265 
types of records C-232 
virtual terminals C-239 
Passthru record C-209 
patch 

disk/diskette, PA $DISKUT2 

command U-147 
Remote Management Utility 

defaults C-283 
storage, $P operator command 

S-63, U-18 
storage or registers, PATCH 
$DEBUG command U-98 
PATCH modify storage or registers, 

$DEBUG, command U-98 
PAUSE operator intervention, 

$JOBUTIL command U-28^ 
PC plot curve 

$DICOMP subcommand U-119 
from plot curve data member 
($PDS) S-255 
PD pulse DO, $IOTEST command 

U-265 
PF,code TERMCTRL function L-288 
PF keys (see program function 

keys) 
phase execution and loading, 

$S1ASM 1-255 
PI process interrupt (see process 

interrupt) U-267 
FID program directory S-27 
PIXB (see primary-level index 

block) 
PL/I 

execution requirements S-24 
link editing S-71 
overview S-8 
program preparation 
requirements S-23 
supported by Multiple Terminal 
Manager C-200 
PL plot data, $DICOMF subcommand 

U-122 
plot control block (see PLOTCB) 
plot curve data member ($PDS) 

S-251 
PLOTCB graphics plot control 

block L-210 
FLOTGIN graphics instruction 
coding description L-210 
overview L-26 
POINT 

disk/tape instruction 

coding description L-212 
overview L-22, S-54 
point-to-point (BSC) S-65 
point-to-point vector drawing 

S-46 
POST 

post an event, $DEBUG command 



U-100 
task control instruction 
coding description L*i 
internals 1-58 
overview L-42, S-34 
supervisor function tHI 
power outage, restoring after 

S-129 
PR print member, $DICOMP comm^ittd 

U-108 
precision L-19 

floating-point arithmetic 

L-21 
integer and logical L-19 
precision combinations, 
allowed L-20 
precision table 
ADD L-53 
ADDV L-54 
DIVIDE L-101 
MULTIPLY L-206 
overview L-20 
SUBTRACT L-284 
prefind U-302 

PREPARE IDCB command L-175 , 
PRGRMS volume. Multiple Termihlil 

Manager C-120, C-173 
primary 

commands, $FSEDIT U-218 
option menu, $FSEDIT U'-ZIS 
option menu, session manager 

S-218, U-35 
task 

internals 1-29 
overview S-29 
volume S-60 
primary-level index block 
description S-195 
overview S-151 
PRINDATE terminal I/O instructibW 
coding description L-215 
overview L-44, S-^7 
timei — related instruction 
S-33 
PRINT listing control statemeht 
coding description L-216 
overview L-28 , 

print member, PR $DICOMP command 

U-108 
FRINTEXT terminal I/O instrudtitltli 
coding description L-217 
overview L-4^, S-47 
return codes L-219 
PRINTIME terminal I/O instruction 
coding description L^221 
overview L-44, L-50# 8-47 
timei — related instruction 
S-33 
PRINTNUM terminal I/O instruct<6i^ 
coding description L--222 
overview L-44, S-47 
PRINTON define terminal namei 

$RJE2780/$RJE3780 C-75 
priority 

assigned to tasks S-29 
design feature S-13 
illustrated S-38 
internals 1-31 
task L-226, L-286 
PROC identify nested t3rocedurti# 

$JOBUTIL command U-286 
procedures, session manager (Hi^lit 

session manager) 
PROCESS Indexed Access Method 
CALL 
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1-128 



S-15 
L-189 



wi th 
PSW) 

U-352 



coding description L-347 
overview L-27, S-147 
return codes L-349 
process interrupt 

control block (SBIOCB) 
description S-48 
lODEF statement L-189 
lOTEST command U-267 
supported by sensor I/O 
user routine (SPECPI) 
process mode 

definition S-150 
processing compiler output 

$LINK or $UPDATE U-360 
processor status word (see 
PROGEQU L-13 
program 

equates 1-312 
assembly/compi lati on 
control L-32 
disabling S-102 
entry (see $FSEDIT, $EDIT1/N) 
function (PF) keys L-^7 
internals 1-108 
listing, KEYS $IMAGE 

command U-253 
listing 4978, $PFMAP 

utility U-301 
when using $FONT edit 

mode U-206 
when using $FSEDIT U-211 
when using $IMAGE edit 

mode U-255 
when using session 
manager U-28 
header 1-30 
identifier, $JOBUTIL command 

U-287 
internal processing 1-30 
library update (see $UPDATE) 
load process, $PREFIND U-302 
loading (see also LOAD) 1-19 
module sectioning functions 

L-33 
organization S-29 
sequencing functions L-34 
structure S-29 
termination, EXIO 1-126 
types 1-32 
program check error messages 

U-427 
program execution via Remote Man- 
agement Utility 

EXEC function C-220 
PASSTHRU function C-225 
SHUTDOWN function C-251 
PROGRAM identifier, $JOBUTIL 

command U-287 
program preparation 

$EDXASM 1-211, U-356 

$S1ASM 1-253, U-372 

host assembler U-382 

of Remote Management Utility 

1-184 
summary S-18 
usage example S-367 
Program Preparation Facility 
description S-71 
overview S-5 
program preparation 

U-351 
program preparation 

(session manager) 
program/storage manager. 
Terminal Manager M-4 



program structure S-36 

internals 1-33 
program/task concepts 1-29, S-29 
PROGRAM task control instruction 

coding description L-225 

internals 1-30 

overview L-42, S-31 
PROGSTOP task control statement 

coding description L-234 

overview L-42, S-31 
prompting and advance input, 

terminal I/O L-46 
protected field S-307, U-253 
protocol, BSC transmission 1-156 
PSW processor status word U-430 
PU PUNCHO/PUNCHS function, 
$RJE2780/$RJE3780 reset type 
C-76 
pulse a digital output address, PD 

$IOTEST command U-264 
PUNCHO/PUNCHS define output file, 

$RJE2780/$RJE3780 C-75 
purpose of EDL L-1 
PUT Indexed Access Method CALL 

coding description L-350 

overview L-27 

return codes L-351 
PUTDE Indexed Access Method CALL 

coding description L-352 

overview L-27 

return codes L-353 
PUTEDIT data formatting 
i nstruction 

coding description L-236 

overview L-18 

return codes L-238 
PUTSTORE TERMCTRL function L-288 
PUTUP Indexed Access Method CALL 

coding description L-354 

overview L-27 

return codes L-355 
Px L-8 



uti li ti es 

uti li ti es 
OU-36, S-214 
Multiple 



QCB task contr 
coding des 
overvi ew 
queue cont 
1-54 
QD queue descr 
QE queue entry 
functi ons 
overvi ew 
processi ng 
QUALIFY modify 
$DEBUG comman 
QUESTION termi 
coding des 
overvi ew 
queuable resou 
queue control 
queue descript 
queue entry (s 
queue processi 
queue processi 

L-37 
queue processi 
QUEUEIO, desc 
QUEUEIO queue 
module descri 



ol statement S-33 

cription L-240 

L-42 

rol block 1-45, 

iptor 1-64, L-37 

1-64 
L-37 
S-32 

base address, 
d U-101 

nal I/O instruction 
cription L-242 
L-44, S-47 
rce S-33 
block (see QCB) 
or (see QD) 
ee QE) 
ng 1-64 
ng instructions 

ng support module, 
ription 1-81 
processing support 
ption 1-81 
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RA reassign address, $TERMUT1 com- 
mand U-'336 
random access S-53 
random work file operation, 

$S1ASM 1-260 
RCB (see Remote Management 

Utility, control block) 
RDCURSOR terminal I/O instruction 
coding description L-244 
overview L-44, S-47 
RE 

copy from basic exchange data 

set, $COPY command U-59 
rename, $TERMUT1 command 

U-337 
rename member, $DISKUT1 com- 
mand U-135, U-136 
rename member, $DIUTIL 

command U-161 
reset parameters, $IAP1UT1 

command U-243 
restore 4974 to standard 
character set, $TERMUT2 
U-339 
read 

analog input, AI $IOTEST 

U-268 
character image table from 

4978* GET $FONT U-206 
data set into work file 
$EDIT1 U-177 
$EDIT1N U-176 
$FSEDIT U-216 
digital input, DI $IOTEST 

command U-266 
digital input using external 

sync U-266 
Host Communications Facility, 

TP operand C-95 
IDCB command L-175 
operations (BSC) 1-157 
program, RP command 
$UPDATE U-410 
$UPDATEH U-419 
READ instruction 

disk/diskette return codes 

L-249, U-455 
di sk/di skette/tape I/O 
i nstructi on 

coding description L-245 
overview L-22 
tape return codes L-249, 
U-456 
READDATA read data from host, 

$HCFUT1 command C-108 
READID IDCB command L-175 
READOBJ read object module, 

$HCFUT1 command C-109 
READTEXT terminal I/O instruction 
coding description L-251 
overview L-44, S-48 
return codes L-255 
return codes, virtual terminal 
communications L-256 
ready a task supervisor execution 

state 1-43 
READ! IDCB command L-175 
READ80 read 80 byte records, 

$HCFUT1 command C-109 
real image ACCA terminals C-7 



realtime data member 
$PDS S-251 

RT $DICOMP subcommand U-124 
RECEIVE function 

overview C-243 
sample program C-262 
RECONNECT Multiple Terminal 

Manager utility C-120, C-159 
record 

blocking. Remote Management 

Utility C-211 
definition S-53 
exchange. Remote Management 

Utility C-208 
format for object module, 

$LINK U-407 
header. Remote Management 

Utility C-209 
sizes. Host Communications 
Facility C-83 
reformat di skettes U-68 
register, index L-6 
register, software L-6 
register conventions 
$S1ASM 1-257 
BSCAM processing 1-147 
common emulator setup routine 

1-68 
EBCDIC to floating-point 

conversion 1-205 
summary chart $S1ASM 1-258 
terminal I/O support 1-106 
REL release a status record, 

$HCFUT1 command C-110 
relational statements L-180 
RELEASE 

Host Communications Facility, 

TP operand C-96 
Indexed Access Method CALL 
S-147 

coding description L-356 
overview L-27, S-147 
return codes L-357 
release a status record, REL 

$HCFUT1 command C-110 
release space ($PDS) S-261 
relocating program loader 1-19 
relocation dictionary, $EDXASM 

1-250 
REMARK operator comment, $JOBUTIL 

command U-288 
remote job entry to host, 

$RJE2780/$RJE3780 C-73 
Remote Management Utility 
CDRRM equates C-292 
control block (RCB) 

description 1-164, 1-169 
equate tables C-292, 

1-295 
use in problem determi- 
nation 1-190 
defaults C-283 
error handling C-277 
function table 1-164, 1-167 
functions C-206, 1-166 
installation C-281 
interface C-207 
internals 1-216 
logic flow 1-170 
messages C-279 
modifying defaults C-283 
module descriptions 1-191 
module list 1-186 
operation C-213 
overlay function processor 
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table 1-167, 1-220 
overlay table 1-167, 1-220 
overview C-205 
program preparation 1-184 
requirements C-207 
sample host programs C-259 
system generation 

considerations C-281 
TERMINAL statement example 

S-107 
terminating C-251 
remote system (see Remote 

Management Utility) C-205 
remove breakpoints and trace 

ranges, OFF $DEBUG command U-97 
rename member 

RE $DISKUT1 command U-135, 

U-136 
RE $DIUTIL command U-161 
RENUM renumber lines 

$EDIT1/N subcommand U-196 
$FSEDIT primary command U-224 
reorganize an indexed data set 
U-242 

procedure S-166 
report data member ($PDS) S-251 
reposition line pointer (see move 

line pointer) 
Request record C-209 
reserved labels L-4 
reset 

function, $RJE2780/$RJE3780 

attention request C-76 
IDCB command L-i76 
Indexed Access Method 

ECHO mode, EC $IAMUT1 com- 
mand U-240 
SE command parameters, RE 
$IAMUT1 command U-243 
line command, $FSEDIT primary 
command 11-225 
RESET task control instruction 
coding description L-258 
overview L-42, S-31 
resident assembler routines 1-256 
resolution, enhanced 1-201 
resolution, standard graphics 

1-201 
resource control, supervisor 1-54 
restart, automatic S-129 
restore 

disk or disk volume from tape, 

RT $TAPEUT1 command U-326 
dump volume utility, $MOVEVOL 

U-294 
4974 to standard character 
set, RE $TERMUT2 command 
U-343 
resulting field (EOR) L-122 
return codes (see also completion 
codes) 

$DISKUT3 S-319, U-444 

$PDS U-445 

BSC C-57, U-446 

CONVTB L-80 

CONVTD L-83 

data formatting instructions 

U-447 
DELETE L-330 
DISCONN L-333 
ENDSEQ L-355 
EXIO U-448 

EXIO instruction L-131 
EXIO interrupt L-132 
EXTRACT L-337 



FADD L-136 

FDIVD L-138 

FILEIO C-145 

floating point instruction 

U-450 
FMULT L-145 

formatted screen image U-450 
FSUB L-160 
FTAB C-I38, L-373 
GET L-340 
GETSEQ L-343 
in Remote Management Utility 

control block 1-190 
Indexed Access Method U-451 
LOAD L-199, U-452 
LOAD (Indexed Access Method) 

L-346 
Multiple Terminal Manager 

U-453 
PRINTEXT L-219 
PROCESS L-349 
PUT L-351 
PUTDE L-353 
PUTEDIT L-238 
PUTUP L-355 
READ disk/diskette L-249, 

U-455 
READ tape L-250, U-456 
READTEXT L-255 
RELEASE L-357 
SBIO U-457 

SBIO instruction L-262 
SETPAN C-135 
tape L-77 
TERMCTRL L-288 
terminal I/O L-255, U-458 
ACCA U-459 
i nterprocessor 
communications C-31, 
U-460 
virtual terminal L-256, 
U-461 
TP (Host Communications Facil- 
ity) C-102, U-463 
WHERES L-316 
WRITE disk/diskette L-320, 

U-455 
WRITE tape L-320, U-456 
return from immediate action 

routine (SUPEXIT) 1-49 
return from task level (SUPRTURN) 

1-49 
RETURN program control 
i nstructi on 

coding description L-259 
overview L-32, S-31 
supervisor entry point 1-279, 

1-313 
supervisor interface 1-62 
REW (rewind tape) L-75 
rewind tape, MT $TAPEUT1 command 

U-324 
RH reassign hardcopy, $TERMUT1 

command U-338 
RI read 
t ran spa r en t/non- transparent, 
$BSCUT2 command C-68 
RJE (see Remote Job Entry) 
RLOADER 1-19, 1-22 

RLOADER/RLOADRU module 
description 1-78 
RO reorganise indexed file, 

$IAMUT1 command U-242 
ROFF (rewind offline) L-75 
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roll screen, terminal I/O L-48, 

S~293 
RP read program 

$UPDATE command U-410 
$UPDATEH command U-419 
RPQ D02038, 4978 display station 
attachment C-6, S-97 
different device 
configurations C-8 
RSTATUS IDCB command L-175 
RT 

activate realtime data member, 

$DICOMP subcommand U--124 
change realtime data member 

rtame ($PDS) S-258 
disk or disk volume from tape, 
$TAPEUT1 utility U-326 
RWI read/write non-transparent, 

$BSCUT2 command C-58 
RWIV read/write non-transparent 

conversational, $BSCUT2 C-71 
RWIVX read/write transparent 

conversational, $BSCUT2 C-70 
RWIX read/write transparent, 

$BSCUT2 command C-67 
RWIXMP read/write multidrop 
transparent, $BSCUT2 command 
C-60 






SA save data, $DICOMP subcommand 

U-124 
SAVE 

data set on disk, $IMAGE com- 
mand U-254 
work data set, $EDIT1/N 
subcommand U-197 
save current task status 

(TASKSAVE) 1-54 
save data> SA $DICOMP subcommand 

U-124 
save disk dr disk volume on tape, 

$TAPEUT1 utility U-330 
save storage and registers, $TRAP 

utility U-348 
SB special PI bit, $IOTEST 

command U-267 
SBAI sensoh based I/O support 

module description 1-80 
SBAO sensor based I/O support 

module description 1-80 
SBCOM sensor based I/O support 

module description 1-80 
SBDIDO sensor based I/O support 

module description 1-80 
SBIO sensor based I/O instruction 
coding description L-260 
control block (SBIOCB) 1-127 
overview L-39, S-51 
return codes L-262 
SBIOCB sensor based I/O control 

block 1-127 
SBPI sensor based I/O support 

module description 1-80 
SC save control store, $TERMUT2 

command U-343 
screen format builder utility, 

$IMAGE S-68, U-250 
SCREEN graphics instruction 
coding description L-270 
overview L-26 



screen image format building 

U-250 
screen images, retrieving and dis- 
playing S-300 
screen management, terminal I/O 

L-48 
SCRNS volume. Multiple Terminal 

Manager C-120, C-173 
SCRNSREP, Multiple Terminal 

Manager C-125 
scrolling, $FSEDIT U-210 
SCSS IDCB command L-176 
SE set parameters, $IAMUT1 

command U-244 
SE set status, $HCFUT1 command 

C-110 
second-level index block 
description S-197 
overview S-153 
secondary 

disk volumes S-132 
volumes S-60 
secondary option menus S-218, 
U-36 

(see session manager) 
sectioning of program modules 

L-33 
sector S-52 

self-defining terms L-4 
send 

data, HX $DICOMP subcommand 

U-118 
data set, SEND function C-247 
message to another terminal, 
$TERMUT3 utility U-344 
SEND function 

internals 1-166, 1-172 
overview C-247 
sample program C-274 
sensor based I/O 

assignment L-188 

I/O control block (SBIOCB) 

1-127 
modules (lOLOADER/IOLOADRU) 

1-78 
statement overview L-39 
support module descriptions 

1-81 
symbolic L-9 
SENSORIO configuration statement 

S-51, S-84 
sequence chaining L-27 
sequencing instructions, program 

L-34 
sequential access 

in Indexed Access Method 

S-145 
overview S-53 
sequential work file operations 

($S1ASM) 1-259 
serially reusable resource (SRR) 

1-59, S-33 
session, PASSTHRU 

conducting C-227 
establishing C-225 
logic flow diagram C-230 
using $DEBUG utility C-272 
session manager U-27 

$SMALLOC data set allocation 

control data set S-222, U-30 
$SMDELET data set deletion 

control data set S-222, U-32 
adding an option S-209, S-224 
communications utilities U-42 
communications utilities 
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S-217 
data management S-215 
diagnostic utilities 

S-217 
disk utilities (see data 

management) 
execute program utilities 

S-216 
graphics utilities S-216 
job stream processor 

utilities S-216 
logon menu U-27 
primary S-218, U-35 
program preparation 

utilities S-214 
secondary S-218, U-36 
summary of S-213 
terminal utilities S-215 
updating primary option 
S-224 
creating a new menu S-224 
data management U-38 
data set deletion U-32 
data sets creation U-29 
diagnostic utilities U-43 
execute program utilities 

U-41 
graphics utilities U-^0 
invoking U-27 
invoking a $JOBUTIL procedure 

S-229 
job stream processor 

utilities U-42 
menus U-33 
minimum partition size 

required U-27 
operational overview S-209 
primary option menu, $SMMPRIM 

S-218, U-35 
procedures 

communications utilities 

S-217 
data management utilities 

S-215 
diagnostic utilities 

S-217 
execute program utilities 

S-216 
graphics utilities S-216 
job stream processor 

utilities S-216 
overview S-220 
program preparation 

utilities S-214 
terminal utilities S-215 
updating S-225 
program function keys U-28 
program preparation utilities 

U-36 
secondary option menus S-218, 

U-36 
storage usage S-211 
terminal utilities U-40 
text editing utilities U-36 
utilities not supported U-46 
SET, ATTN TERMCTRL function L-288 
set breakpoints and trace ranges, 

AT $DEBUG command U-90 
set date and time, $T operator 

command S-63, U-19 
SET Host Communications Facility 

TP operand C-97 
SET,LPI TERMCTRL function L-288 
set status, SE $HCFUT1 command 
C-110 



set tape offline, MT $TAPEUT1 com- 
mand U-324 
set time, $T operator command 

U-19 
SETBUSY supervisor busy routine 

1-^8, 1-63 
SETCUR, Multiple Termi.ial Manager 
CALL 

coding description C-137, 

L-378 
internals M-9 
overview C-117, L-29 
SETEOD subroutine S-324 
SETPAN, Multiple Terminal Manager 
CALL 

coding description C-134, 

L-379 
internals M-9 
overview C-117, L-29 
return codes L-380 
setup procedure for $JOBUTIL 

U-271 
SG special PI group, $IOTEST com- 
mand U-267 
SHIFTL data manipulation 
i nstructi on 

coding description L-271 
overview L-19 
SHIFTR data manipulation 
i nstructi on 

coding description L-273 
overview L-19 
SHUTDOWN function C-251, 1-166, 

1-181 
SI save image store, $TERMUT2 com- 
mand U-341 
SIGNON/SIGNOFF, Multiple Terminal 
Manager C-156 

SIGNONFL C-17^ 
single program execution 1-35 
single-task program 1-33 
single task program S-34 
SIXB (see second-level index 

block) 
SLE sublist element, $EDXASM 
format of 1-217 
in instruction parsing 

($EDXASM) 1-220 
instruction description and 

format 1-229 
used in $IDEF 1-241 
software register L-6 
software trace table S-265 
sort/merge S-9 

source program compiling S-71 
source program entry and editing 

S-66, U-351 
source program line continuation 

using $EDXASM L-4, U-361 
source statements, $EDXASM overlay 

generated 1-243 
SP spool function, 
$RJE2780/$RJE3780 reset type 
C-76 
SPACE listing control statement 
coding description L-275 
overview L-28 
special control characters S-46 
special PI 

bit, SB $IOTEST command U-267 
group, SG $IOTEST command 
U-267 
specifications, data conversion 
L-146 
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SPECPI define special process 

interrupt L-189 
SPECPIRT instruction 

coding description L-276 
overview L-39 
split screen configuration S-293 
SPOOL define spool file, 
$RJE2780/$RJE3780 C^76 
SQ set prompt made, $C0PYUT1 

command U-64 
SQRT data manipulation 
instruction 

coding description L-277 
overview L-19 
SS Set program storage parameter, 

$D1SKUT2 command U-1^9 
ST 

display data set status, 

$D1UTIL command U-162 
save disk or disk volume on 
tape, $TAPEUT1 command U-330 
standard labels, tape 
EOFl S-240 
EOVl S-239 
fields S-238 
HDRl S-239 
header label S-235 
layouts S-236 
processing S-236 
trailer label S-235 
volume label S-235 
VOLl S-238 
START 

IDCB command L-176 
PROGRAM statement operand 
L-225 
start and termination procedure, 

$DEBUG U-85 
STARTPGM 1-16 
statemeht label L-4 
static screen, terminal I/O 
accessing example S-297 
overview L-48 
status, set, SE $HCFUT1 command 

C-110 
STATUS data definition statement 
coding description L-278 
overview L-17 
status data set, system Host 

Communications Facility C-85 
Status record C-258 
STIMER timing instruction 

coding description L-280 
overview L-50, S-32 
with PASSTHRU function C-238 
storage estimating 

application program size 

S-344 
supervisor size S-333 
utility program size S-342 
storage management 

address relocation translator 

1-71, S-42 
allocating 1-25 
description S-42 
design feature S-13 
Storage map, resident loader 1-26 
storage map ($S1ASM) phase to 

phase 1-262 
storage resident loader, RLOADER 

1-19 
storage usage during program load 

1-20 
store next record ($PDS) S-261 
Store record ($PDS) S-261 



strings, relational statement 

L-180 
SU 

submit (X) function, 

$RJE2780/$RJE3780 reset type 

C-77 
submit job to host, $HCFUT1 

command C-111 
SUBMIT 

Host Communications Facility, 

TP operand C-98 
send data stream to host, 

$RJE2780/$RJE3780 C-77 
submit job to host, $EDIT1 

command U-179 
submit job to host, $FSEDIT 

option U-217 
SUBMITX send transparent, 

$RJE2780/$RJE3780 C-77 
SUBROUT program control statement 
coding description L-281 
overview L-32, S-31 
subrouti nes 

$IMDATA S-303 
$IMDEFN S-301 
$IMOPEN S-300 
$IMPROT S-302 
ALTIAM concatenation S-167 
DSOPEN S-322 
overview S-31 
SETEOD S-324 
SUBTRACT data manipulation 
i nstructi on 

coding description L-283 
overview L-19 
precision table L-284 
suggested utility usage U-48 
supervi sor/emulator 

class interrupt vector table 

I-IO, 1-277 
communications vector table 

I-ll, 1-278, 1-313 
control block pointers I-ll 
design features S-13 
device vector table I-ll, 

1-278 
emulator command table 1-13, 

1-282, 1-301 
entry routines 1-47 
equate table 1-279, 1-313 
exit routines 1-49 
features S-13 
fixed storage area 1-9 
functions 1-44 

calling 1-60 
generation 1-5, S-H5 
initialization control module, 

EDXINIT, description 1-81 
initialization task module, 

EDXSTART, description 1-81 
interface routines 1-61 
introduction 1-5 
module names and entry points 

S-309 
module summary 1-8 
overview S-29 

PASSTHRU session with C-225 
referencing storage locations 

in 1-12 
service routines 1-53 
size, estimating S-333 
task supervisor work ar&a 

1-13, 1-280 
utility functions (see 

operator commands) 
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with the address translator 
support 1-72 
SUPEXIT supervisor exit routine 

1-49, 1-63 
support for optional features 

L-15 
SUPRTURN supervisor exit routine 

1-49 
surface analysis of tape, $TAPEUT1 

utility U-319 
SVC supervisor entry routine 

1-47, 1-62 
SVCABEND supervisor exit routine 

1-49 
SVCBUF supervisor request buffer 

1-48 
SVCI supervisor entry routine 

1-48 
symbol dictionary, $EDXASM 1-250 
symbol table types, $EDXASM 1-216 
symbolic L-10 

address (disk, tape) L-10 
disk/tape I/O assignments 

L-10 
diskette L-10 

reference to terminals S-110 
sensor I/O addresses L-9 
terminal I/O L-10 
symbols (EXTRN) L-134 
symbols (WXTRN) L-323 
syntactical coding rules L-4 
syntax checking in instruction 

parsing ($EDXASM) 1-221 
syntax rules L-4 
SYSGEN (see system generation) 
system 

alternate logging device 

S-46, S-111 
class interrupt vector table 

I-IO, 1-277 
commands (see operator 

commands) 
common area 1-12 
communications vector table 

I-ll, 1-278, 1-313 
control blocks, referencing 

1-289 
data tables, EDXSYS, module 

description 1-75 
device vector table I-ll, 

1-278 
emulator command table 1-13, 

1-282, 1-301 
generation 

procedure S-115 
host/remote C-205 
logging device S-46, S-110 
operational and error 

messages LI-421 
printer S-46, S-110 
program check and error 

messages U-427 
task supervisor Mork area 
1-13, 1-280 
SYSTEM configuration statement 

L-39, S-86 
system configuration statements 

S-75 
system control blocks S-42 
system reserved labels L-4 
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TA allocate tape data set, 

$TAPEUT1 command U-333 
tables, parameter equate L-11 
tabs 

HTAB $IMAGE command U-252 
TABSET $EDIT1/N subcommand 

U-198 
VTAB $IMAGE command U-254 
TABSET establish tab values 

$EDIT1/N editor subcommand U-198 
tape 

bypass label processing S-244 
control L-74 
data set L-40 
defining volumes S-62 
definitions for data sets 

L-40 
end-of-tape (EOT) L-41 
I/O instructions L-40 
internals 1-97 
labels 

external S-233 
internal S-233 
load point (BOT) L-40 
non-label 

layout S-242 
processing S-243 
support S-241 
record L-40 

return codes L-77, U-455 
standard label 

fields S-238 
layout S-236 
processing S-236 
support S-235 
storage capacity S-59 
symbolic addressing L-10 
utility, $TAPEUT1 S-233, 

U-311 
volume L-40 
TAPE configuration statement S-94 
tape data set control block 1-99 
tape device data block (see TDB) 
TAPEINIT, tape initialization mod- 
ule description 1-82 
tapemark L-74 
task 

active/ready level table 1-50 

concepts 1-29 

control 1-42 

control block (see TCB) 

definition and control func- 

ti ons 
dispatching 1-52 
error exit facility 

check and trap handling 

S-268 
linkage conventions S-269 
execution states 1-43, S-39 
internals 1-42 
multiple-task program 1-33, 

S-34 
overview L-42, S-29 
priority (see priority, task 

executi on) 
single-task program 1-33, 

S-34 
states S-39 
status display, WHERE $DEBUG 

command U-102 
structure S-29 
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supervisor 1-42 

supervisor address translator 

support module 1-76 
supervisor functions 1-44 
supervisor work area 1-13/ 

1-280 
switching 1-51, S-30 
synchronization and control 
1-54, S-30 
task code words L-8 
TASK task control statement 
coding description L-285 
overview L-42, S-31 
TASKSAVE supervisor service 

routine 1-54 
TCB task control block 1-32, 

1-43, 1-49, 1-56, 1-314 
TCBEQU L-13 
TD 

display line and data ($PDS) 

S-258 
display time and date, $DICOMP 

subcommand U-124 
test display, $DICOMP command 
U-108 
TDB, tape device data block 
description 1-97 
equate listing 1-316 
TEB terminal environment block 

C-128, ri-13 
Tektronix C-6 

devices supported S-14, S-45 
support for digital I/O S-312 
teleprocessing (see TP) 
teletypewriter adapter C-7, C-21 
TERMCTRL terminal I/O instruction 
coding description L-288 
overview L-44 
return codes L-301 
TERMERR L-44 
termi nal 

#7850 teletypewriter adapter 

C-21 
ACCA support C-7, L-295 
ASCII C-7 
assignment list, LA $TERMUT1 

command U-336 
attention handling L-47 
attention keys L-47 
code types C-303 
configuration utility, 

eTERMUTl U-334 
connected via digital I/O 

S-312 
control block (see CCB) 
data representation L-46 
definition and control 

functions S-47 
device configurations C-8 
EDXTIO/EDXTIOU module 

description 1-78 
environment block (see TEB) 
error handling L-44 
forms control L-46 
forms interpretation for 

display screens L-46 
functi ons 

data formatting C-16 
definition C-16 
interrupt processing C-17 
hardware jumpers C-18 
I/O L-46 

attention handling L-47 
data representation L-45 
error handling L-44 



forms control L-45 
prompting and advance 

input L-46 
screen management L-48 
I/O internal design 1-105 
I/O support layer 3 1-112 
input L-46 
keyboard and ATTNLIST tasks 

L-47 
message sending utility, 

$TERMUT3 U-344 
new I/O terminal support 

1-117 
operations C-14 
operator signals L-49 
output L-46 

output line buffering L-46 
program function keys L-47 
prompting and advance input 

L-46 
return codes C-20, L-219, 

L-255, U-458 
roll screens L-48 
sample terminal support 

program C-26 
screen management L-48 
server. Multiple Terminal 

Manager C-119, M-7 
session manager (see session 

manager) 
special considerations for 

attachments of devices 

via #1610 or #2091 with 

#2092 adapters C-17 
via #2095 with #2096 
adapters C-21 
special control characters 

S-46 
static screens L-48 
supported devices and 

features C-6 
terminal I/O L-47 
terminology for supported 

terminals C-7 
transmission protocol C-31 
utilities (session manager) 

S-215, U-40 
virtual I/O 1-115 
TERMINAL configuration statement 
defaults S-105 
definition S-96 
overview S-48 
TERMINAL volume. Multiple Terminal 

Manager C-120, C-171 
termi nate 

logging, $LOG utility U-292 
Remote Management Utility 

C-251 
test 

BSC lines, $BSCUT2 utility 

C-64 
generated report or graphics 

profile member U-108 
label types, $TAPEUT1 utility 

U-319 
process interrupt for 

occurrence of event, $IOTEST 

U-267 
TEXT data definition statement 
coding description L-305 
overview L-17 
text editing utilities 

edit dataset subroutine exam- 
ples 1-326 
full screen-editor $FSEDIT 
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U-209 
line editors, $EDIT1/N U-169 
overview S-66 
work data set, format of 
1-321 
text wrapping, WRAP function 

C-254 
time/date 

display, $UI operator command 

U-25 
set, $T operator command U-19 
set, automatic initialization 
facility S-130 
time of day 

GETTIME instruction L-167 
TIMEDATE Host Communications 
Facility, TP operand C-100 
TIMER configuration statement 

S-33, S-112 
timer control L-50 
timer module descriptions 

(EDXTIMER, EDXTIMR2) 1-80 
timing instructions L-50, S-32 
TITLE listing control statement 
coding description L-308 
overview L-28 
TONE TERMCTRL function L-288 
TOP repostiton line pointer, 

$EDIT1/N editor subcommand U-200 
TP host communication instruction 
descri pti on 

coding description C-90 
internals 1-153 
subcommand operations 1-157 
TPCOM host communications support 

module description 1-81 
trace printing routine for BSC, 

$BSCUT1 C-62, S-65 
trace ranges and breakpoints 

setting, AT $DEBUG command U-90 
trace routine for BSC, $BSCTRCE 

C-61 
trace table, software S-265 
transaction program. Multiple 
Terminal Manager 
functions L-28 
Multiple Terminal Manager 
C-121 
transfer data set to host 
SEND function C-247 
WR $HCFUT1 command C-112 
WRITE $EDIT1 command U-180 
WRITE $FSEDIT option U-216 
transfer rates for data. Host 

Communications Facility C-84 
transient program loader 1-19 
transmission codes S-98 
transmission protocol, host 

communications 1-156 
transmitted data, length of, host 

communications 1-159 
TRAPDUMP force trap dump, $TRAP 

attention command U-3^9 
TRAPEND end $TRAP use, $TRAP 

attention command U-349 
TRAPOFF deactivate error trap, 

$TRAP attention command U-349 
TRAPON activate error trap, $TRAP 
attention command U-349 



H 



UN unload indexed file, $IAMUT1 

command U-246 
UNBLINK TERMCTRL function L-288 
undefined length records, tape 

S-2^5 
UNLOCK TERMCTRL function L-288 
unprotected field S-307, U-253 
UP move line pointer, $EDIT1/N 

editor subcommand U-201 
update utility 

$UPDATE convert object program 

to disk U-408 
$UPDATEH convert host object 
program to disk U-418 
updating a menu for the session 

manager S-224 
user defined data member ($PDS) 

S-252 
user exit routine L-310 

requires Macro Assembler S-71 
user initialization modules 1-17 
USER program control instruction 
coding description L-310 
overview L-32 
utilities U-^7 

BSC communications C-61 
invoking U-2 
listed by type S-64, U-3 
overview S-5 
utilities not supported by session 

manager menu U-46 
utility program size S-342 
utility usage U-48 
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V verify, $INITDSK command U-260 
VA 

display, variable, $DICOMP 

subcommand U-125 
display variable ($PDS) S-254 
variable length record. Host 

Communications Facility C-8^ 
variable length records, tape 

S-244 
variable names L-4 
vary disk, diskette, or tape 

offline, $VARYOFF U-20 
vary disk, diskette, or tape 

online, $VARYON U-22 
vector 

addition L-19, L-54 
data manipulation L-19 
vector addition (ADDV) 

coding description L-54 
overview L-19 
veri fy 

disk or diskette data set, V 

$INITDSK U-260 
tape executing correctly, EX 

$TAPEUT1 command U-319 
tape surface free of defects, 
EX $TAPEUT1 command U-319 
verify and initialize disk or 

diskette library, $INITDSK U-256 
verify identification 
host system C-223 
remote system C-223 
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VERIFY VQrify changes, $EDIT1/N 

editor subcommand U-202 
vertical tabs, defining U-254 
VI list volume information, 

$IOTEST command U-270 
virtual terminal communications 
accessing the virtual termi- 
nal S-281 
creating a virtual channel 

S-280 
establishing the connection 

S-280 
intei — program dialogue S-282 
internals 1-115 
loading from a virtual 

terminal S-281 
Remote Management Utility 
requirements C-281 
volume 

definitions Cdi sk/di skette) 

L-22, S-52 
dump restore utility, 

$MOVEVOL U-294 
labels S-60 
VTAB define vertical tab setting, 
$IMAGE command U-254 



CALL 

coding descript 

L-381 
internals M-9 
overview C-118 
save work data set 
$EDIT1 command 
$EDIT1N command 
$FSEDIT primary 
U-216 
tape I/O instructio 
coding descript 
overview L-22 
return codes L 
write data set to host, 

command C-112 
write operations, HCF 
WRITEl IDCB command L- 
WS put program in wait 

$IOTEST command U-264 
WTM (write tape mark) 
WXTRN program module se 
statement 

coding description 
overview L-33 
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, L-29 



U-180 

U-181 
opti on 



ion L-317 

-320, U-456 
WR $HCFUT1 

1-156 

175 

state, 

L-75 
ctioning 

L-323 
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WAIT program sequencing 
coding description 
overview L-42, S-31 
supervisor function 
1-58 
wait state, put program 
$IOTEST command U-264 
waiting, task execution 

1-43 
WE copy to basic exchang 
data set, $COPY command 
WHERE display status of all tasks, 

$DEBUG command U-102 
WHERES task control function 
coding description L-315 
overview L-'^2, S-287 
return codes L-316 
WI write non-transparent, $BSCUT2 

command C-69 
WIX write transparent, $BSCUT2 

command C-69 
word boundary requirement 
DO L-34 
IF L-34 
PROGRAM L-225 
work data set 

$EDXASM 1-249 
$LINK U-400 
$S1ASM I-25S 
work files, $S1ASM, 

1-258 
WR write a data set 
$HCFUT1 command C 







X-type 


statement 


XI ext 


L-313 




comma 
XO ext 


1-45, 




comma 
XYPLOT 


in, WS 




CO 
OV 


state 




YTPLOT 

CO 


e di sk€ 


tte 


OV 


U-63 




ZCOR, 



how used 

to host, 
■112 



WRAP function C-254, 1-166, 1-176 
WRITE 

disk/diskette I/O instruction 
coding description L-317 
overview L-22 
return codes L-320, U-455 
Host Communications Facility, 

TP operand C-101 
IDCB command L-175 
Multiple Terminal Manager 



format L-154 
ernal sync DI, $IOTEST 
nd U-266 

ernal sync DO, $IOTEST 
nd U-266 

graphics instruction 
ding description L-324 
erview L-26 

graphics instruction 
ding descrition L-325 
erview L-26 
sensor I/O L-189 
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C-7 
2092 asynchronous communications 
four line adapter C-6 

considerations for attachment 

of devices C-17 
different device 

configurations C-8 
to attach ACCA terminal S-99 
use with different terminals 

C-7 

2095 feature programmable eight 
line controller C-6 

considerations for attachment 

of devices C-21 
different device 

configurations C-8 
use with different terminals 

C-7 

2096 feature programmable four 
line adapter C-6 

considerations for attachment 

of devices C-21 
different device 

configurations C-8 
use with different terminals 

C-7 
2741 Communications Terminal 
supported S-<+5 
TERMINAL statement example 

S-106 
3101 Display Terminal 

attribute character C-122 
block mode considerations 

C-25 
character mode considerations 

C-22 
interface with Multiple 

Terminal Manager C-121, L-29 
TERMINAL configuration 

statement examples S-108 
3585 4979 display station 
attachment C-6, S-97 

4952 Processor 
partitions on S-42 
timer feature installed on 

S-32 

4953 Processor 
partitions on S-42 
timer feature installed on 

S-32 
4955 Processor 

partitions on S-42 

timer feature installed on 

S-32 

4962 Disk Storage Unit 
storage capacity S-58 
supported by Indexed Access 

Method S-146 

4963 Disk Subsystem 
storage capacity S-58 
supported by Indexed Access 

Method S-146 

4964 Diskette Storage Unit 

part of minimum system config- 
uration S-22 

required for program 
preparation S-22 

supported by Indexed Access 
Method S-146 
4966 Diskette Magazine Unit 

part of minimum system config- 
uration S-22 

required for program 
preparation S-22 



supported by Indexed Access 
Method S-146 
4969 Magnetic Tape Subsystem 
S-233 

4973 Line Printer 

defined in TERMINAL configura- 
tion statement S-96 
end of forms S-307 
TERMINAL statement example 
S-105 

4974 Matrix Printer 

defined in TERMINAL configura- 
tion statement S-96 

end of forms S-307 

restore to standard character 
set, RE $TERMUT2 U-339 

TERMINAL statement example 
S-105 

4978 Display Station 

defined in TERMINAL configura- 
tion statement S-96 

part of minimum system 
configuration S-22 

reading modified data S-307 

required for program 
preparation S-22 

TERMINAL statement example 
S-105 

4979 Display Station 

defined in TERMINAL configura- 
tion statement S-96 
part of minimum system 

configuration S-22 
required for program 

preparation S-23 
TERMINAL statement example 
S-105 
4982 sensor I/O unit S-84 
5230 Data Collection Interactive 

S-11 
5620 4974 matrix printer 
attachment C-6 

defined in TERMINAL statement 

S-97 
different device 
configurations C-8 
5630 4973 line printer attachment 
C-6 

defined in TERMINAL statement 
S-97 
5719-AM3 (see Indexed Access 

Method) 
5719-ASA (see Macro Assembler) 
5719-CB3 (see COBOL) 
5719-CB4 (see COBOL) 
5719-F02 (see FORTRAN IV) 
5719-LM3 (see 
Mathematical/Functional Subrou- 
tine Library) 
5719-LM5 (see Macro Library) 
5719-MSl (see Multiple Terminal 

Manager) 
5719-SM2 (see Sort/Merge) 
5719-UT3 (see Utilities) 
5719-UT4 (see Utilities) 
5719-XSl (see Basic Supervisor and 

Emulator) 
5719-XX2 (see Program Preparation 

Faci 1 i ty) 
5740-LM2 (see Macro Library/Host) 
5799-TDE (see Data Collection 

Interact i ve) 
7850 teletypewriter adapter C-6, 
C-21 
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